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PREFACE 



The Macro Assembler lor the CONTROL DATA^' 1700 Computer System is a 3-pass 
assembler which can convert source language input including macro instructions to 
relocatable output and generate list output. The source programs are written with 
symbolic machine, pseudo, and macro instructions. 

Macro definitions may be defined by the user within the source program, or they may 
be placed on a separate macro library. 

Input is from the standard input device, binary output is to the standard output device, 
and list output is to the standard list device. 

The following describe functions occurring in each pass of the assembler. 

Pass 1 

Programmer defined macros are processed and appropriate tables are built. 
Whenever a macro instruction is encountered, the macro skeleton with ar-tual 
parameters substituted is inserted into the source input on the mass storage device. 

The source input is copied onto the mass storage device. 

Sequence numbers of the input source images are checked. 

Pass 2 

Each source image on the mass storage device is read and pass 2 errors are 
listed as they occur. 

Conditional assembly pseudo instructions are processed. 

Symbol and external tables are built. 

Pass 3 

Each image is read and pass 3 errors are listed. 

List and relocatable binary output are generated according to the input options. 

TABLST 

TABLST prints and punches the entry points and external images. The transfer 
image is punched. 

An EOF image is output to the next load-and-go sector on mass storage. 

A symbol table listing is given. 
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XREF 

XREF creates and prints the cross-references lists. 

Refer to the 1700 Mass Storage Operating System (MSOS) 4 Reference Manual equipment 
configuration for the minimum hardware required by the Macro Assembler. 

It is assumed that users of this manual are familiar with the 1700 MSOS. 



Following is a list of 1700 MSOS m.anuals. 
Description 

1700 MSOS 4 Reference Manual 

1700 MSOS 4 Mass Storage FORTRAN 
Version 3 A/B Reference Manual 

1700 MSOS 4 Computer System Codes 

1700 MSOS 4 Macro Assembler 
General Information 

1700 MSOS 4 Mass Storage FORTRAN 
General Information 

1700 MSOS 4 Small Computer Maintenance 
Monitor Reference Manual 

1700 MSOS 4 Instant 

1700 MSOS 4 File Manager Version 1 
Reference Manual 

1700 MSOS 4 Release Bulletin 

1700 MSOS 4 Installation Handbook. 

1700 MSOS 4 Small Computer Maintenance 
Monitor Instant 

1700 MSOS 4 Ordering Bulletin 

1700 MSOS 4 General Information 



Pub. No. 
60361500 

60362000 
60163500 

39519800 

39519900 

39520200 
39520500 

39520600 
39520800 
39520900 

39521700 

39521900 
39522400 
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INSTRUCTION FORMAT 



I.I 3\JVK\.C rK\J\»K.fKn\ 

The number of independent subprograms com.prising a source program is limited only 
by available space. Each subprogram may be assembled independently, or several 
may be assembled as a group. The main subprogram of a group is the one to which 
initial control is given; it need not be the first subprogram. The last subprogram 
of a group must be followed by the MON pseudo instruction indicating the end of assem- 
bly and return to the operating system. 

Communication between subprograms is effected by the subprogram linkage pseudo 
instructions and by the use of common and data storage. 

At execution time, the entry point named in the END pseudo instruction specifies the 
entry point to which initial control passes. A jump to the dispatcher or an exit 
request (1700 MSOS Reference Manual) signals return of control to the operating 
system upon job completion. EXIT or a jump to the dispatcher must be the 
last statement to be executed. 

1.2 SOURCE STATEMENT 

A source statement consists cf location, instructions, address, remarks, and se- | 

quence fields. The first four fields may not exceed 72 characters; within that limi- 
tation they are free field. The sequence field is used when the source image is 80 
characters; it is restricted to columns 73 through 80. 

Each field is terminated by a tab {$B; paper tape only), carriage return (end of state- 
ment mark), or blanks. Any number of blanks may separate fields. A carriage re- 
turn is always the end of statement mark on paper tape. 

1.2.1 LOCATION FIELD 

The location field of a source statement must begin in column 1. 

This field is used to specify a labeled (label starting in column 1) or an unlabeled (blank 
or tab in column 1) statement. 

The statement label is a symbolic name consisting of from 1 to 6 alphanumeric char- 
acters; the first must be alphabetic. Characters in excess of six are ignored. A 2- 
character name makes the most efficient use of storage and assembly time. 

Examples: 

LOOPl Legal 

123456 Illegal; first character is numeric 

PI Legal 

A123456 Legal; only A12345 is processed 
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1.2.2 REMARKS 

An asterisk in column 1 of the location field specifies that the source statement is a 
remark. Comments, written in columns 2 through 72, are printed with the assembly 
list output but have no effect on the object program. An asterisk elsewhere in the 
location field is illegal. Remarks may also follow the address field of any instruction. 
There must be at least one blank separating the address field from the remarks. 

1.2.3 INSTRUCTION 

This field begins to the right of the location field and must be separated from it by at 
least 1 blank character or a tab. If the location field contains no label (blank or tab 
on column 1). the operation code may begin in column 2. 

The operation code field contains the three-letter instruction codes for machine and 
pseudo instructions; or it contains macro instructions which may be up to 6 characters. 
Certain instructions may be followed by a 1 -character terminator. 

rni -• „ J — 4. 4.i — « — 1„^ ij^ + ^^ .*« A.^^^w,^,",r A r,«^ ^ ^r-. «-«-;k^^ ; v^ +Urt ^n^\^\ 

X lit: iiiiieiiiuiiHJ iiiaui u^LiuLi ^-uiaco xioLCta m jr^i^pc uvula x-i. cui c vjco*-x i.kjc»-* m uiic j. i \jkj 

Computer Reference Manual. 

1.2.4 ADDRESS FIELD 

The address field begins to the right of the operation code field, separated from it by 
at least 1 blank character or a tab. It is terminated by a blank or tab, or by the 
72nd character of the source statement. Exceptions are the macro instructions which 
may have a continuation line and the pseudo instruction ALF (section 3.3.2). 

This field contains an address expression consisting of an operand or string of oper- 
ands joined by arithmetic operators; or it may contain a series of operands separated 
by commas. An operand may be any of the following: 

Symbolic name 

Numeric constant 

One of the special characters: * A Q M 1 B 

Symbolic Operand 

A symbolic name used as an operand in the address field must be defined in one of 
the following ways. 

Label in the location field of any machine instruction 

Label in the location field of any macro instruction 

Label in the location field of constant declaration pseudo instructions: 
ADC, ALF, NUM, DEC, VFD 

Symbolic name in the address field of the pseudo instructions: EXT, 
COM, DAT, BSS, BZS, EQU 
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A defined symbolic name references a specific location in memory. It may be re- 
locatable or absolute. A relocatable symbol refers to a location that may be relocated 
during loading. 

Storage is divided into three areas: program, data, and common. These areas are 
defined at assembly time and the initial location of each is set to a relocation address 
of zero. the object code produced by the assembler contains addresses which are 
modified by a relocation factor to produce the actual address in memory. 

A symbol is program^ relocatable if it references a location in the subprogram, data 
relocatable if it references a location in data storage, and common relocatable if it 
references a location in common storage. All other symbols are absolute. A symbol 
is made absolute by equating it to a number, an arithmetic expression, or another 
absolute symbol. 

In all cases a symbolic label and a symbol defined by BSS or BZS take the relocation 
and value of the current location counter. The location counter of a program is 
originally program relocatable, however, its relocation may be changed by the ORG 
instruction. 

An address expression which includes more than one operand must reference only one 
relocatable area. Terms of different relocation types must reduce to one relocatable 
area or to an absolute address. When the address mode of an instruction is made 
one-word relative by an asterisk terminator , the relocation type of the address ex- 
pression must agree with the type of the current location counter. 

A syiiiboiic opei-anu may be preceuea oy a plus or a minus sign, it pi-eceOect by a plus 
or no sign, the symbol refers to its associated value; if preceded by a minus, the 
symbol refers to the ones complement of its associated value. When an expression 
contains more than one symbol, the final sign of the expression is the algebraic sum 
of the operands. 

Example: 

RT relocation type of current location counter; P program relocatable, C common 
relocatable, D data relocatable, and A absolute address. 

RT Label 



Operation 


Address 


COM 


COMl. COM2 


DAT 


DATl. DAT2 


EQU 


D(l). E(3).G(E-D). H{$1000).I(DAT1) 


BZS 


A,B,C 


BZS 


J,K(10) 



p 
p 

The symbols D, E. G. and H are absolute; UAT1,DAT2. and I are data relocatable: 
COMl and COM2 are com.mon relocatable; A, B, C, J, and K are program relocatable. 

P <5TapT Apr' n 

P LDA* START 

P STA* DATl (Error) 

P STA* COMl (Error) 
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The errors resulted because the relocation types of the symbols in the address 
field do not match that of the location counter, and the one-word relative address 
mode was requested by an asterisk terminator. 



RT 
P 



Label 



Operation 
LDA + 



Address 



(Not an error) 
Relocations need not match when mode is two-word absolute. 



P 
P 



LDA 
LDA 



START (O. K. , relocations match) 
COMl (Not an error) 



Assembler changes this instruction to two-word absolute because relocations do not 
match, but no error is indicated. 



LDA 



COM2-DAT1+COM1-D+E-COM2+START-K+DAT2 



This address expression results in a common relocation type; all other relocations 
cancel out (refer to address expressions). 

ORG DATl 

ORG changes the relocation of the location counter to data. 



D 
D 



LDA* 
ST A* 
ORG* 



START (Error) 
DAT2+9 



ORG* returns the location counter to original relocation. 



A 
A 
A 
A 



LDA* 


START 


(Not an error) 


ORG 


H 




LDA* 


START 


(Error) 


STA* 


DATl 


(Error) 


LDA* 


$1001 




STA- 


B 




ORG* 






END 







Numeric Operand 

A numeric operand in the address field rnay be decimal or hexadecimal. A decimal 
number is represented by up to five decimal digits and must be within the range 
±32767. A hexadecimal number is represented by a dollar sign and not more than 
four hexadecimal digits in the range ±7FFF. (Hexadecimal operands in the NUM 
pseudo instruction nnay be in the range ±FFFF. ) 

Numeric operands in the address field may be preceded by a plus or a minus sign. If 
a plus or no sign is specified, the binary equivalent of the number is the value used; 
I a minus means the one's complement of the binary equivalent is the value. 

A numeric operand has no relocation type; it is always absolute. 
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following arithmetic operators. 



/ 



Subtraction 

Multiplication 

Division 



Arithmetic operators may not follow each other without an intervening operand. Paren- 
theses are not permitted for grouping terms. 

The asterisk has an additional meaning as an operand. When it is used as the mul- 
tiplication operator (refer to special characters), it must be immediately preceded by 
an operand which may be another asterisk. When the asterisk is used as an operator, 
only one of its associated operands may be relocatable. 

The slash, used as the division operator, must be between two operands. The operand 
which follows mav not be zero or relocatable. 

An pxterna) namp mav he ii=;pri m an STirirps's pxnressinn nnlv as a sinfTle operand. 
Arithmetic operators preceding or following an external operand are illegal. 



Example: 








NAM 


EXAM PL 




COM 


A.B 




EQU 


C(1),D(5) 




EXT 


G 




BZS 


E(10). F 


START 


LDA 


D-C/5+**2 




ADD 


A-B/2 




ADD 


E+5 




STA 


G 




END 





The first asterisk in the LDA instruction refers to the value of the current location 
counter. 

The following instructions are illegal assuming the same pseudo instructions precede 
the START. 



START LDA 
ADD 
ADD 
STA 



D_C*=i=5+2 
A-2/B 
E*F 
G+5 



*5 has no intervening operator 
Division by relocatable operand 
Both operands are relocatable 
An external must stand alone 
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The hierarchy for the evaluation of arithmetic expressions is: 

/ or * Evaluated first 
+ or - Evaluated next 

Expressions containing operators at the same level are evaluated from left to right. 
The expression 

A/B+C*D 
is evaluated algrebraically as 

A/B+(C)(D) 
and not as any of the following: 

(A)(D) A A 



B+C (B+C)(D) B+(C)(D) 

Parentheses may not be used for grouping operands. The algrebraic expression 

(A-D)(B+C/E) 
must be specified 

A*B+A*C/E-D*B-D*C/E 
The following expression is illegal. 

(A-D)*(B+C/E) 

Division in an address expression always yields a truncated result; thus, 11/3 = 3. The 
expression A*B/C may result in a value different from B/C*A. For example, if A=4. 
B = 3, and C = 2 then 

A*B/C=4*3/2 = 6 but 
B/C*A = 3/2*4=4 

All expressions are evaluated modulo 2^^-l. An address expression consisting solely 
of numeric operands is absolute. If an expression contains symbolic operands, the 
final relocation for the expression is determined by the relocations of the symbolic 
operands. If the relocation of the operands is expressed by the following terms, the 
final relocation is the algebraic sum of the relocation terms. 

±P Positive or negative progrann relocation 

±C Positive or negative common relocation 

±D Positive or negative data relocation 

The relocation must reduce to one of the relocation terms or to zero. If zero, the 
location is absolute. 
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Examole: 



aource statements 



COM 


A.B 


DAT 


CD 


EQU 


E(1).F(D) 


STRT LDA 


B+C-E*2-A-D 


LDA 


B+D-F+STRT-A-C 


LDA 


B+D-E+STRT-A-C 


LDA 


B-D-A 


Special Characters 





neiOcailuli jr (jiiiiuia 



+C+D-C-D = (absolute) 
+C+D-D+P-C-D = P-D (illegal) 
+C+D+P-C-D = P (program) 
+C-D-C = -D (negative data) 



Special characters may be used as operands in the address field of a source statement. 
Their definition may not be changed by the user. The three classes of special char- 
acters are storage, register, and index. 



Class 



Storage 



T? p cT'i =;t p'^ 



Index 



Character 



A 
Q 
M 


Q 
I 

B 



Referenced Location 

Current location counter 
Location FF.g 

A register 
Q register 
Mask register 
Destination registers 

Index 1, Q register 
Index 2, location FFjs 
Index 1 plus index 2 



Storage class characters (*, I) reference storage locations. The asterisk refers to the 
location of the current instruction. For a word instruction, an asterisk references the 
location of the first word. Special character I refers to location FF;^q. I is the only 
indexing character that may stand alone as an operand with storage reference instructions. 
It may not be defined as a location symbol in a program. 

The register class characters (A, Q, M, and ) are used only with inter-register transfer 
instructions. They refer to the A, Q, and M (mask) registers. Character sets the 
destination registers to zero (section 2. 5). 



Examples: 

Instruction 
SET A.Q, M 
TRA Q 

LAM M 



Function 

Set A, Q, and mask registers to ones 

Transfer contents of A register to Q register 

Transfer logical product of A and mask register to mask 
register 
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Index class characters (Q, I, and B) are used in conjunction with an address expression to 
refer to the index registers. Any one character may follow an address expression; it is 
separated from the expression by a comma with no intervening blank. Indexing may be used 
only with storage reference instructions. 

Q Contents of Q register are added to contents of the expression to form 

the actual address 

I Contents of location FFjg are added to contents of address expression 

to form the actual address 

B Contents of Q register are added to address expression and this sum is 

added to contents of FF^g to produce the actual address 

Examples: 

Function 



LOCl.B 



Legal Contents of registers Q and FFis and the contents 

of LOCI are added to produce the actual address 



,.l 



Illegal Character following first comma is assumed to be 

index character 



TAG2,Q, I Illegal Only one index notation allowed 

Q Illegal Unless Q has been previously defined as a location 

symbol or is being used with the inter-register 
transfer instruction, it must follow a location symbol 

TAGS, I Legal Contents of FF^g and TAGS are added to produce 

the actual address 

1.2.5 COMMENT FIELD 

The address field is followed by the comment field which is used for remarks. Re- 
marks do not affect the object code, but are printed as part of the list output. The 
comment field terminates at column 72, or with a carriage return (paper tape). Blanks 
are permitted in the comment field. 

1.2.6 SEQUENCE FIELD 

When the input im.age is 80 characters, columns 73 through 80 are available for se- 
quencing; 73 through 75 may be used for program identification, 76 through 80 for a 
sequence number. 

Sequence numbers are checked for errors only if the input image is 80 characters. 
Each sequence number must be greater than or equal to the previous sequence number. 
The value of a character in the sequence number is in ASCII code except that a blank 
is treated as zero. 
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MACHINE INSTRUCTIONS 



Machine instructions i epi eseuted by a three-letter mnemonic code are divided into six 
classes. 



Group A storage reference 
Group B storage reference 
Register reference 



Shift 
Skip 
Inter-register transfer 



Storage reference instructions result in one or two machine words, depending on 
modification. Other machine instructions result in one machine word. 

The function of each machine instruction is discussed in detail in the 1700 Computer 
Reference Manual. Appendix A lists the machine instructions in the order in which 
they are discussed in this chapter. 

2.1 STORAGE REFERENCE INSTRUCTIONS 

Group A and B storage reference instructions use storage addresses as operands or as 
operand addresses. Group B instructions include jump instructions and may not use 
the constant mode of addressing. 



2.1.1 ADDRESS MODES 

Group A storage reference instructions allow three modes of addressing: absolute, 
relative, and constant. Group B does not allow the use of the constant mode, but is 
otherwise the same as Group A. 

Special characters designate the mode of addressing, the number of words for the 
instruction, and indirect addressing. 



Character 







Description 

Asterisk as the last character of operation code specifies relative 
addressing in a one-word instruction 

Minus as the last character of operation code specifies absolute 
addressing in a one-word instruction 

Plus as the last character of operation code specifies absolute 
addressing in a two -word instruction 

Equal sign as the first character in address field preceding a 
constant indicates constant addressing; the instruction is always 
two words 

Parentheses enclosing the address expression indicate indirect 
addressing 



60361900B 



2-1 



If no character is specified as a terminator to the operation code, two-word relative 
addressing is assumed with the following exceptions. 

1. If a constant is specified, the constant m.ode is assum.ed. 

2. If the relocation type of the address expression differs from the relocation 
type of the location counter, two-word absolute addressing is assumed. 

3. If a nonrelative external is referenced, absolute addressing is assumed. 

The machine language format resulting from a storage reference instruction is illustrated 
as follows. 

First word: 



15 


11 


10 


9 


8 


7 


f 


r 


d 


q 


i 


A 



f 4-bit operation code is described in 1700 Computer Reference Manual 

r Specifies relative addressing 

d Specifies indirect addressing 

q Index register 1 flag; specifies adding contents of Q register to address 

i Index register 2 flag; specifies adding contents of storage register FF^^g 
to address 

A 8-bit field; may be relative or absolute address for one-word instructions. 
When zero, indicates two-word instruction. 

Second word (when used): 

15 ' 



15 14 



16-bit field for constant addressing or relative address, 
relative address, bit 15 is the sign. 





When it contains 



m 



b Indirect address bit 

m Memory address 

Address expressions are evaluated modulo 2l5_i. 
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2.1.2 ABSOLUTE ADDRESSING 



The value of the address expression of a one-word absolute instruction must be non- 
rcj.ocai.3.tjj.e. i lie evaraaLeu resuit is stored in 8 bits of the machine word. If this 
value is greater than 256, it is flagged as an error. If the 8-bit A field is zero, 
two machine words are assumed regardless of the operation code terminator; no error 
message is printed. If the address expression is enclosed in 






K^f ■{ n ^f 



not^on+Vickci^c 






W V_;J. l_l 1.0 OCL 



Examples: 

One Word, Direct 

Instruction: 

LDA- e 
Machine Word: 



15 



LDA 



11 10 











One Word, Indirect 

Instruction- 

ADQ- (e) 
Machine W^ord: 



15 



11 10 



ADQ 







The value of the address expression of a two-word absolute instruction is stored in 
the least significant bits of the second word. If the expression is enclosed in paren- 
theses for indirect addressing, bit 15 of the second word is set to 1. The indirect 
address bit 10 in the first word is always set to 1 when two-word absolute addressing 
is specified whether the address expression is specified as indirect or direct. This 
indicates that the address expression is in the second word. The 8-bit A field of the 
first word is set to zero for two-word instructions. 

Examples: 

Two Word, Direct 

Instruction: 

EOR+ e 
Machine Words: 



15 


11 


10 


9 


8 


7 


EOR 





1 








00 



15 14 
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Two Word, Indirect 

Instruction; 

AND+ (e) 
Machine Words: 



15 




11 


10 


9 


8 


7 







AND 





1 








00 


15 14 

















1 


• 



2.1.3 RELATIVE ADDRESSING 

When one-word relative addressing is specified, the value of the current location 
counter is subtracted (16-bit ones complement arithmetic) from the evaluated address 
expression. The result is placed in the 8-bit A field. If the value of the result 
is outside the range ±7F-|^g, an error condition is flagged. An error condition is 
also flagged if the relocation type of the address expression differs from that of the 
location counter. If the 8-bit A field is zero, two words are assumed regardless of 
the operation code terminator. No error message is printed for this condition. 

Examples: 

One Word. Direct 

Instruction: 

AND* e 
Machine Word: 



15 



11 10 



^ 



AND 



One Word. Indirect 

Instruction: 

MUI* (e) 
Machine Word: 



15 


1 1 


in 


9 


8 


7 


MUI 


1 


1 








e-* 
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In the expression e-* the asterisk indicates the value of the current location counter. 

When a two-word instruction is specified, the value of the current location counter 
plus one is subtracted (using 16-bit I's complement arithmetic) from the value of 
the address expression to obtain the 16-bit second word. If the relocation type of the 
address expression differs from that of the location counter and the address does not 
^ ^^K^ ^..^^ d.. fc!x„ex wa^, wic asoeiiiDier lurues a two-wora absolute instruction. If the 
address expression is an external reference, the instruction is absolute or relative 
depending on the definition of the external. 

Examples: 

Two Word. Direct 

Instruction: 

LDQ e 
Machine Words: 



15 


11 


10 


9 


8 


7 







LDQ 


1 











00 


15 





















e 


-■ = 1 








1 
i 



Two Word. Indirect 

Instruction: 

LDA (e) 
)VIachine Words: 



15 


11 


10 


9 


8 


7 


LDA 


1 


1 








00 



15 



e-*-l 



In the expression, e-*-l, the asterisk indicates the value of the current location counter. 
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2.1.4 CONSTANT ADDRESSING 



Constant addressing may be used only for Group A storage reference instructions. 
^^onstant.s m i,iie s^^ress xiei»_i are prece«_i6ij ^y an equai sign ana a one-ietter coue. 
A constant may be one of the following: 

Meaning 

2 alphanumeric characters 

5-digit decimal number with or without a leading sign 

4-digit hexadecimal number preceded by $, with or without 
a sign 

Address expression evaluated modulo 2-^^-1 

Address expression evaluated modulo 2-'-^-l, with bit 15 set 

Examples: 

DVI 

ADD 

LDA 

AND =XTAGl+5 (Address expression constant) 

An instruction containing a constant in the address field results in two machine words. 

Example: 



Code 


Type 


A 


aa 


N 


iddddd 


N 


±$hhhh 


X 


e 


X 


(e) 



=N$1000 

=N-12345 

=AXY 



(Hexadecimal constant) 
(Decimal constant) 
(ASCII constant) 



Instruction: 

DVI =nc 

Machine Words: 



(n is the code, c is the constant) 



15 




11 


10 


9 


8 


7 







DVI 

















15 



















c 



2.1.5 DATA TRANSMISSION INSTRUCTIONS 

STQ (F==4) 



STA (F=6) 



Store Q. Store the contents of the Q register in the storage location 
specified by the effective address. The contents of Q are not altered. 

Store A. Store the contents of the A register in the storage location 
specified by the effective address. The contents of A are not altered. 
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SPA (F = 7) 



Store A. Parity to A. Store the contents of the A register in the storage 
xu>_a.Lnjii apcLiiicu uy Liic ciicuLivti tiuuresH. v^iear ±\ IT tne numoer ot 
1 bits in A is odd. Set A equal to 0001 ^g if the number of 1 bits in A 
iS even. The contents of A are aut altered if the write into storage is 
aborted because of parity error or protect fault. 



LDA (F = C) Load A. Load the A register with the contents of the storage location 
■^ p\^ ^ J. J. j.v^ ^ ^j L4j^ v^iit v^Lj. V *i c3.y^\jL 1. ^ o o , xijc v^uiiLciiua Kji Liit; bLui'ayfcj iuca~ 
tion are not altered. 

LDQ (F = E) Load Q. Load the Q register with the contents of the storage location 
specified by the effective address. The contents of the storage loca- 
tion are not altered. 

2.1.6 ARITHMETIC INSTRUCTIONS 

All the following arithmetic operations use one's complement arithmetic. 



MUI (F = 2) 



Multiply Integer. Multiply the contents of the storage location, speci- 
fied by the effective address, by the contents of the A register. The 
32 -bit product replaces the contents of Q and A, the most significant 
bits of the product in the Q register. 



DVI 



(F 



^) 



r)iv/iri^j Tn1(=»(it-'r 



ni\ 



by the contents of the effectiv^e address. The Q register contains the 



r r 1 n s 1 S I nri 1 1 H • H •" 1 *^ h 1 ^ s" h p t ^ 



i 1 ^^1 m r 



]f^-Hi+ Hi^.'irianH 



into A, the sign bit of A must be extended throughout Q. The quotient 
is in the A register and the remainder is in the Q register at the end 
of the divide operation. 

The OVERFLOW indicator is set if the magnitude of the quotient is 
greater than the capacity of the A register. Once set, the OVERFLOW 
indicator remains set until a Skip On Overflow (SOV) or Skip On No 
Overflow (SNO) instruction is executed. 

ADD (F = 8) Add to A. Add the contents of the storage location, specified by the 
effective address, to the contents of the A register. 

The OVERFLOW indicator is set if the magnitude of the sum is 
greater than the capacity of the A register. Once set, the OVERFLOW 
indicator remains set until a Skip On Overflow (SOV) or Skip On No 
Overflow (SNO) instruction is executed. 



SUB (F = 9) Subtract From A. 



RAO (F = D) 



Subtract the contents of the storage location, 
specified by the effective address, from the contents of the A register. 
Operation on overflow is the same as for an Add to A instruction. 

Replace Add One in Storage. Add one to the contents of the storage 
location specified bv the effective a.ddress. The contents of A are 
not altered. Operation on overflow is the same as for an Add to A 
instruction. 



ADQ (F = F) 



Add to Q. Add the contents of the storage location, specified by the 
effective address, to the contents of the Q register. Operation on 
overflow is the same as for an Add to A instruction. 
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2.1.7 LOGICAL INSTRUCTIONS 

The AND (AND with A) instruction achieves its results by forming a logiceil product. A 
logical product is a bit-by-bit multiplication of two binary numbers according to the 
following rules: 



0x0 = 
0x1 = 



1x0 = 
1x1 = 1 



Example: 

0011 Operand A 
X 0101 Operand B 

0001 Logical Product 

A logical product is used, in many cases, to select only specific portions of an operand 
for use in some operation. For example, if only a specific portion of an operand in 
storage is to be entered into the A register, the operand is subjected to a mask in A. 
This mask is composed of a predetermined pattern of Os and Is. Executing the AND 
instruction causes the operand to retain its original contents only in those bits which 
have Is in the mask in A. 

The EOR (Exclusive OR with A) instruction achieves its result by forming an exclusive 
OR. Executing the EOR instruction causes the operand to complement its original con- 
tents only in those bits which have Is in the mask in A. An exclusive OR is a bit-by-bit 
logical subtraction of two binary numbers according to the following rules: 



Exclusive OR 




A 


B 


A -v 


B 


1 
1 




1 

1 





1 
1 





Example: 












0011 
X 0101 


Operand A 
Operand B 






0110 


Exclusive OR 



AND (F = A) AND with A. Form the logical product, bit-by-bit, of the contents of 
the storage location specified by the effective address and the contents 
of the A register. The result replaces the contents of A. The con- 
tents of storage are not altered. 



EOR (F = B) 



Exclusive OR with A. Form the logical difference (exclusive OR), 
bit-by-bit, of the contents of the storage location specified by the 
effective address and the contents of the A register. The result 
replaces the contents of A. The contents of storage are not altered. 
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2.1.8 JUMP INSTRUCTIONS 

A Jump (JMP) instruction causes a current program sequence to terminate and initiates a 
new sequence at a different location in storage. The program address register, P, pro- 
vides continuity between program instructions and always contains the storage location of 
the current instruction in the prograna. 

When a Jump instruction occurs, P is cleared and a new address is entered. * In the 
Jump instruction, the effective address specifies the beginning address of the new pro- 
gram sequence. The word at the effective address is read from storage and interpreted 
as the first instruction of the new sequence. 

A Return Jump (RTJ) instruction enables the computer to leave the main program, jump 
to some subprogram, execute the subprogram, and return to the main program via 
another instruction. The Return Jump provides the computer with the necessary informa- 
tion to enable returning to the main program. Figure 2-1 shows how a Return Jump 
instruction can be used. 



MAIN 

PROGRAM 

ADDRESS 



MAIN 
PROGRAM 



SUBPROGRAM 



P| RT.i 
i 



ETi i:rTi\ K 

\ nnrj rcc = aa < 



rOMPfTKR STORKS p+i/p+v HFRF 



^. 



o 



■*■ 16 

1 1 



P+1 



P+2 



0026 



16 



ST 
1 INSTRUCTION OF SUBPROGRAM 
1 



p 






t 




LAST INSTRUCTION OF SUBPROGRAM 









JMP 


INDIRECT ADDRESS=0025,„ 
16 











Figure 2-1. Program Using Return Jump Instruction 



Jumps or return jumps from unprotected to protected storage cause a fault, but the 
address that is saved in the trap location is the destination address (i.e., the address 
of the next sequential main program instruction). 
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A Return Jump instruction is executed at main program address P. The computer jumps 
to effective address 0025^5 and stores P + 1 or P + 2 (depending on the address mode of 
RTJ) at this location. Then the program address counter P is set to 0026]^g and the 
computer starts executing the subprogram. At the end of the subprogram, the computer 
executes a Jump instruction (JMP) with indirect addressing. This causes the computer 
to jump to the address specified by the subprogram address 0025^6 (P + 1 or P + 2 of 
the main program). Now main program execution continues at P + 1 or P + 2. 



JMP (F = 1) 



RTJ (F = 5) 



Jump. Jump to the address specified by the effective address. This 
effectively replaces the contents of program address counter P with 
the effective address specified in the Jump instruction. 

Return Jump. Replace the contents of the storage location specified 
by the effective address with the address of the next consecutive 
instruction. The address stored in the effective address is P + 1 
or P + 2, depending on the addressing mode of RTJ. The contents 
of P are then replaced with the effective address plus one. 



2.2 REGISTER REFERENCE INSTRUCTIONS 

Register reference instructions use the address mode field for the operation code. 
Register reference instructions are identified when the upper four bits (15 through 12) 
of an instruction are Os. 

Format: 



15 




12 


11 




8 


7 














Fl 





Instruction 



Modifier (A) 



SLS (F1=0) 



INP (Fl = 2) 



OUT (Fl = 3) 



Selective Stop. Stops the computer if this instruction is executed 
when the selective stop switch is on. On restart, the computer exe- 
cutes the instruction at P+ 1. This becomes a Pass instruction 
when the selective stop switch is off. 

Input to A. Reads one word from an external device into the A regis- 
ter. The word in the Q register selects the sending device. If the 
device sends a Reply, the next instruction comes from P+ 1. If the 
device sends a Reject, the next instruction comes from P + 1 + A, 
where delta is an eight-bit signed number. If an internal Reject 
occurs, the next instruction comes from P + A . Refer to the 1700 
Computer Reference Manual. 

Output from A. Outputs one word from the A register to an external 
device. The word in the Q register selects the receiving device. If 
the device sends a Reply, the next instruction comes from P+ 1. If 
the device sends a Reject, the next instruction comes from P+1+ A, 
where delta is an eight-bit signed number. If an internal Reject occurs, 
the next instruction comes from P+ A . Refer to the 1700 Computer 
Reference Manual. 
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INA (Fl = 9) Increase A. Replaces the contents of A with the sum of the initial 

contents oi A and delta, where delta is treated as a signed number with 
the sign extended into the upper eight bits. Operation on overflow is 
the same as for an Add to A instruction. 

ENA (Fl-A) Enter A . Replaces the contents of the A register with the eight-bit 

NOP (F1 = B) No Operation . This is a Pass instruction (no operation is performed). 
Compares to Selective Stop instruction with the STOP switch off. 

ENQ (F1=C) Enter Q . Replaces the contents of the Q register with the eight-bit 
delta, sign extended. 

INQ (F1 = D) Increase Q. Replaces the contents of Q with the sum of the initial con- 
tents of Q and delta, where delta is treated as a signed number with 
the sign extended into the upper eight bits. Operation on overflow is 
the same as for an Add to A instruction. 

The following instructions (Fl equals 4, 5, 6, 7, or E) are legal only if the program 
protect switch is off or if the instructions themselves are protected (refer to the 1700 
Computer Reference Manual). If an instruction is illegal, it becomes a selective stop 
and an interrupt on program protect fault is possible (if selected). 

• TD„^+„^-4 ^,,,; + „i, „er _ '\t^„»„„i .■,,,.4 4-; — — 4----- I- - < j- ■. 

EIN (Fl=4) Enable Interrupt. Activates the interrupt system after one instruction 
following EIN has been executed. The interrupt system must be 
active and the appropriate mask bit set for an interrupt to be 
recognized. 

UN (Fl = 5) Inhibit Interrupt. Deactivates the interrupt system. If interrupt 

occurs during execution of this instruction, the interrupt is not recog- 
nized until one instruction after the next EIN instruction is executed. 

SPB (Fl = 6) Set Program Protect Bit . Sets the program protect bit in the 
address specified by Q. 

CPB (Fl = 7) Clear Program Protect Bit. Clears the program protect bit in the 
address specified by Q. 

EXI (Fl =E) Exit Interrupt State. This instruction must be used to exit from any 
interrupt state. Delta defines the interrupt state from which the 
exit is taken (see 1700 Computer Reference Manual). At the time an 
interrupt occurs, the value of P is stored in the interrupt trap loca- 
tion assigned to that particular interrupt state. This value is called 
the return address as it enables return to the next unexecuted instruc- 

reads the address containing the return address, then jumps to the 
return address. In addition, if the computer is in 32K mode, this 
instruction also sets the OVERFLOW indicator to the state of bit 15 
in the return address. This bit records the state of the OVERFLOW 
indicator when the interrupt occurred. In 65K mode this instruction 
does not reset the OVERFLOW indicator. Refer to the 1700 Computer 
Reference Manual for an explanation of the overflow condition in 
65K mode. 
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2.3 INTER-REGISTER INSTRUCTIONS 

These instructions cause data from certain combinations of two origin registers to be 
sent through the adder to any combination of destination registers. Various operations, 
selected by the adder control lines, are performed on the data as it passes through the 
adder. 

Format: 



Operand 1 



Adder 



Control 



Lines 



Operand 2 



15 




12 


11 




8 


7 


6 


5 


4 


3 


2 


1 








Fl=8 


L 

P 


X 
R 


A 


Q 


M 


A 


Q 


M 



Logical Product - 



Exclusive OR- 



Destination 
Registers 



Origin 
Registers 



If bit if an Inter- register instruction is set (M is the destination register) and the 
instruction is not protected, it is a program protect violation and becomes a non-protected 
Selective Stop instruction. The Program Protect Fault bit is set and interrupt occurs. 
See the 1700 Computer Reference Manual for additional information. 

The origin registers are considered as operands. There are two kinds. 

• Operand 1 may be: 

- FFFF (bit 5 is 0) or 

- The contents of A (bit 5 is 1) 

• Operand 2 may be: 

- FFFF (bit 4 is and bit 3 is 0) or 

- The contents of M (bit 4 is and bit 3 is 1) or 

- The contents of Q (bit 4 is 1 and bit 3 is 0) or 

- The inclusive OR, bit-by-bit, of the contents of Q and M (bit 4 is 1 and 
bit 3 is 1) 

The following operations are possible. 

• Exclusive OR (LP = and XR - 1) — The data placed in the destination 
register(s) is the exclusive OR, bit-by-bit, of operand 1 and operand 2. 

• Logical Product (LP = 1 and XR = 0) — The data placed in the destination 
register(s) is the logical product, bit-by-bit, of operand 1 and operand 2. 

• Complement Logical Product (LP = 1 and XR = 1) — The data placed in the 
destination register(s) is the complement of the logical product, bit-by-bit, 
of operand 1 and operand 2. 
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Arithmetic Sum (LP = and XR = 0) - The data placed in the destination 
iegistex(e>/ io the birithmetic sum of operand l and operand 2. The 
OVERFLOW indicator operates the same for an Add to A instruction. 



INTER-REGISTER MNEMONICS 

QTrT /XT' 1 — o \^i4.^ n *i u o _ ■»rv/\:rtrt\ 

►-'*-• -^ \J-' A — u, uitD I till UUgll O — luuuuy 

CLR (Fl = 8, bits 7 through 3 = 01000) 
TRA (Fl = 8, bits 7 through 3 = 10100) 
TRM (Fl = 8, bits 7 through 3 = 10001) 
TRQ (Fl = 8, bits 7 through 3 = 10010) 
TRB (Fl = 8, bite 7 through 3 = 10011) 
TCA (Fl = 8, bits 7 through 3 = 01100) 
TCM (Fl = 8, bits 7 through 3 = 01001) 
TCQ (Fl == 8, bits 7 through 3 = 01010) 
TCB (Fl = 8, bits 7 through 3 = 01011) 
AAM (Fl = 8, bits 7 through 3 = 00101) 
AAQ (Fl = 8, bits 7 through 3 = 00110) 
AAB (Fl = 8, bits 7 through 3 = 00111) 
EAM (Fl = 8, bits 7 through 3 = 01101) 
EAQ (Fl = 8, bits 7 through 3 = OHIO) 
EAB (Fl = 8, bits 7 through 3 = 01111) 
LAM (Fl = 8, bits 7 through 3 = 10101) 
LAQ (Fl = 8, bits 7 through 3 = 10110) 
LAB (Fl = 8. bits 7 through 3 = 10111) 
CAM (Fl = 8, bits 7 through 3 = 11101) 
CAQ (Fl = 8, bits 7 through 3 = 11110) 

CAR fFI = R. hits 7 thr-niinVi .'^=11111) 

Note: The "+" implies an inclusive OR. 



oet to unes 

Clear to Zero 

Transfer A* 

Transfer M* 

Transfer Q* 

Transfer Q + M=!< 

Transfer Complement A* 

Transfer Complement M=i^ 

Transfer Complement Q* 

Transfer Complement Q + M* 

Transfer Arithmetic Sum A, M 

Transfer Arithmetic Sum A, Q 

Transfer Arithmetic Sum A, Q + M 

Transfer Exclusive OR A, M 

Transfer Exclusive OR A, Q 

Transfer Exclusive OR A, Q + M 

Transfer Logical Product A, M 

Transfer Logical Product A, Q 

Transfer Logical Product A, Q + M 

Transfer Complement Logical Product A, M 

Transfer Complem.ent Logical Product A, Q 

T'l^a ncf £ar» /"^ /-»rv-i r-»l fi*v-» rty-i+ T ^^i^r^l "Dvi^^im^- A /^ J- T\/r 



The use of bit 7 is optional; it may be a 1 or a 0. The assembler uses bit 7 = 0. 
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2.4 SHIFT INSTRUCTIONS 

The Shift instructions shift A, Q, or QA left or right the number of places specified by 
the five-bit shift count. Right shifts are end-off with sign extension in the upper bits. 
Left shifts are end-around. The maximum long-right or long-left shift is IF places. 

Format: 



15 






12 


11 


8 


7 


6 


5 


4 

















P1=F 











1 = Shift Left _ 
= Shift Right' 



1 = Shift A - 



1 = Shift Q- 



Shift 
Count 



Example: Shift A right two places — 0F42. 



15 




12 


11 




8 


7 


6 


5 


4 








F1=F 











111 



01000010 



SHIFT MNEMONICS 

ARS (Fl = F, bits 7 through 5 = 010) 

QRS (Fl = F, bits 7 through 5 = 001) 

LRS (Fl = F, bits 7 through 5 = Oil) 

ALS (Fl = F, bits 7 through 5 = 110) 

QLS (Fl = F. bits 7 through 5 = 101) 

LLS (Fl = F, bits 7 through 5 = 111) 



A Right Shift 

Q Right Shift 

Long Right Shift (QA) 

A Left Shift 

Q Left Shift 

Long Left Shift (QA) 
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2.5 SKIP INSTRUCTIONS 

Skip instructions result in one machine word: a 12-bit operation code and a 4-bit 
unsigned skip count. The first four bits of the operation code field are set to zero, 

tV\ .^ >^ ^:v 'V+ f /-\ 1 1 v» \~t. i 4- CI /-»/-\vi + «-i'iv^ +!-»/> iT'l^'ii-^ iv^*-i+v»i-ii-t + -i/-\v-^ y~i /-vj-4 »^ iiMlll «-i»-\<-4 4-l-»j-» lr^j-i+ ■P.-«-ii-»™ l-i-«+-(-i /-*r^vi^ 

lie lie A.L J.l^U.X L/i.Lo \..><^ 11 1.0.1.11 L11C> O IVi.^ J. no Li. U.V^ Ll.(.^ll %^t^\.Ae VV/ V J. ^ CLllW. UllC^: XcLO L 1 k^ U.J. U LLO CUll 

tain a unique identifier, F2, for each skip instruction. The expression in the 
address field of the instruction is evaluated modulo 2l5_i_ 

This expression may be absolute or relocatable. If absolute, the value of the expres- 
sion is the skip count. If relocatable, the value of the skip count is obtained by sub- 
tracting (16-bit one's complement arithmetic) the value of the current location counter 
plus one from the expression. The skip count is then placed in the last four bits of 
the machine word. The final value of the skip count must not exceed four bits or an 
error message is printed. If the expression is relocatable, the relocation type of the 
expression must match the relocation type of the location counter or an error results. 

Format: 



15 12 


11 8 


7 6 5 4 


3 











Instruction (F) 



Skip Instruction 



Subinstruction (Fl) 



Skip Count 



When the skip condition is met, the skip count plus one is added to P to obtain the 
address of the next instruction (e.g., when the skip count is zero go to P + 1). When 
the skip condition is not met, the address of the next instruction is P + 1 (skip count 
ignored). The skip count does not have a sign bit. 



SAZ (F2 = 0) 
SAN (F2 = 1) 
SAP (F2 = 2) 
SAM (F2 = 3) 
SQZ (F2 = 4) 
SQN (F2 = 5) 

cop /wo = R\ 

SQM (F2 = 7) 
SWS (F2 = 8) 
SWN (F2 = 9) 



Skip if A is positive zero (all bits are 0) 

Skip if A is not positive zero (not all bits are 0) 

Skip if A is positive (bit 15 is 0) 

Skip is A is negative (bit 15 is 1) 

Skip if Q is positive zero (all bits are 0) 

Skip if Q is not positive zero (not all bits are 0) 

*^U-ir-t if O iG r»r^Gi+ix7i=k ^Kit 1 f^ i « Ol 

Skip if Q is negative (bit 15 is 1) 
Skip if selective skip switch is set 
Skip if selective skip switch is not set 



60361900B 



2-15 



SOV (F2 = A) Skip on Overflow. This instructions skips if 

an overflow condition is sensed. This instruc- 
tion clears the OVERFLOW indicator. 

SNO (F2 = B) Skip on No Overflow. This instruction skips 

if an overflow condition is not present. This 
instruction clears the OVERFLOW indicator. 

SPE {F2 = C) Skip on Storage Parity Error. This instruc- 

tion skips if a storage parity error occurred; 
it clears the Storage Parity Error Interrupt 
signal and the PARITY FAULT indicator. 

SNP (F2 = D) Skip on No Storage Parity Error. 

SPF (F2 = E) Skip on Program Protect Fault. The pro- 

gram protect fault is set by: 

• A nonprotected instruction attempting to 
write into an address that is protected. 

• An attempt to execute a protected 
instruction immediately following a 
nonprotected instruction, unless an 
interrupt caused the instruction 
sequence. 

• Execution of any nonprotected instruc- 
tion affecting interrupt mask or enables. 

The program protect fault is cleared when it 
is sensed by the SPF instruction. The program 
protect fault cannot be set if the program pro- 
tect system is disabled. (Refer to the 1700 
Computer Reference Manual.) 

SNF (Fs = F) Skip on No Program Protect Fault. 

2.6 NEGATIVE ZERO/OVERFLOW SET 

Negative zero and/ or overflow set can be caused by two characteristics of the computer: 

• The computer has a one's complement subtractive adder. 

• Multiplication and division are done with positive numbers only. Therefore, 
a sign correction occurs, if required, before and after the multiplication 

or division symbols. 

Arithmetic operation that produce a negative zero result and/ or set overflow in the 
computer are: 

• Addition (-0) + (-0) = (-0) 

• Subtraction (-0) - (+0) = (-0) 
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• Multiplication (+0) x (-N) = (-0) 

(-N) X (+0) = (-0) 
(-0) X (+N) = (-0) 
(+N) X (-0) - (-0) 

• Division ji^\ = (-0), R = (+0) 

Where: N # ^ ^^' 

R = Remainder , „v 

jj, = (-0), R = (-0) 



FN) 

(-0) 
FN) 



^"°^ = (+0), R = (-0) 



|i^ = (-0), R = (+N) overflow set 
1^ = (-0). R = (-N) overflow set 
|^=(-2), R = (-0) 
J^^ = (+2), R ^ ("0} 
|i^ = (-0), R = (+0) overflow set 
|i^ = (+0), R = (+0) overflow set 
■t^ = (+0), R = (-0) overflow set 
1^ = (-0), R = (-0) overflow set 
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PSEUDO INSTRUCTIONS 



proviue suoprogram iinKage, control output 
listing, reserve storage, convert data, and so on. 

Pseudo instructions may be placed anywhere in a source language subprogram. How- 
ever, OPT or NAM must be the first statement of a subprogram and MON or END 
must be the last statement. 

3.1 SUBPROGRAM LINKAGE 

These instructions identify and link subprograms; a symbolic name in the location field 
is ignored. 

3.1.1 NAM 

NAM identifies a source language subprogram and must be the first statement of the 

subpi'ograri 

precede it. 



aUDprugi'tini. LJIliy lUf Lts&eiublf r uunTlOi p-jfUOu ixiairucjlluli Kji-l vscCiiuii J . -1 , t) ; iTiiiy 



The format is 

NAM s 



s An optional symbolic name of the subprogram which is printed as 
part of the assembly list output. 



3.1.2 END 



END must be the last statement of a source language subprogram. If END terminates 
a subprogram assembled separately or the last subprogram of a group, MON follows 
END. Otherwise END is followed by NAM or OPT. 

The format is 

END s 

s An optional symbolic nanne of an entry point to the first subprogram 
to be executed. If specified, s must be defined as an entry point 
in the subprogram, to which control passes. This entry point may be 
in the same subprogram as the END statement or in a subprogram 

HJCL^^y-^ <3.L (.lie; aCLLLL^ LXlli^. 

Example: 

END START 

START is the location of the first statement to be executed. 
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3.1.3 ENT 

The ENT instruction lists the symbolic names of entry points which may be referenced 
from other subprograms. 



The format is 

ENT si,S2. 



Example: 



ENTl 
ENT2 



.Sr 



s. Entry points listed in the address field of ENT and must be defined in 
the subprogram containing the ENT instruction. s^ must not refer to 
to a location outside the subprogram, common storage, or data 
storage. 



NAM 
ENT 
LDA 
3TA 



PROGl 
ENT1.ENT2 
XYZl 
XYZ2 



(Legal) 



ENT 



ENTX 



(Illegal: ENTX not defined) 



END 



ENTl 



3.1.4 EXT/ EXT* 

The EXT instruction lists the symbolic names of entry points in external subprograms 
which may be referenced from this subprogram. 

The format is 

EXT sj, S2, . . . , Sf, 



Entry points in the address field of EXT, which must be symbols defined 
in the subprograms they reference. s^ must not refer to symbols in 
the same subprogram. 



Example 1: 


NAM 






EXT 


ENT1,ENT2 


ENT3 


LDA 


XYZ 




COM 


ENT5 




EXT 


ENT3 




EXT 


ENT4 




EXT 


ENT5 




EXT 


ENTl 



(Legal) 



(Illegal; ENT3 is same subprogram) 

(Legal) 

(Illegal; ENT5 in common storage) 

(Legal; defined in same way as above) 



END 
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Example 2: 



EXT 



ENT1.ENT2 



T r>A P'lM'ri 

This reference to ENTl results in the following two machine words. 
15 11 10 9 8 7 



LDA 





1 








00 


15 













external link 



External link is a pointer to the location of ENTl used by the loader at load time. 

The EXT* instruction is the same as EXT except that sj are absolute locations in EXT 
and references to Sj are made relative in EXT*, 

The format is 

EXT* SpSg.-.-.s^ 

The plus terminator cannot be used with an operation code when the address references 
a relative external entry point. It is also illegal to enclose an external in parentheses 
in the address field of an ADC instruction (section 3.3.1). 

Examples: 



EXT* NAME1,NAME2. NAMES 
LDA NAMEl 

LDA+ NAMEl 



LDA 
ADC 



(NAME2) 
(NAMES) 



(Illegal) 
(Illegal) 



EXT* NAMEl. NAME2 



.DA 



AP4E1 
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This reference to NAMEl results in the following two machine words. 



15 




11 


10 


9 


8 


7 







LDA 


1 













00 




15 



















external link 







External link is a pointer to the location of NAMEl used by the loader at load time. 

3.2 DATA STORAGE 

The following instructions allocate data storage. BSS and BZS assign storage local to 
the subprogram in which they appear. COM and DAT assign data common to any 
number of subprograms. Symbolic names in the location fields of data storage instruc- 
tions are ignored. 

3.2.1 BSS 

The BSS instruction assigns symbolic nannes to segments of storage within the instruc- 
tion sequence of the subprogram. 



The format is 

BSS Si(ei),S2(e2). . . 

Sj name 

omitted 

e, expression 



' Sn<en) 

Symbolic name which defines the first location of the 
named segment. 

When omitted from a subfield, a segment is assigned with 
the length e but no nam.e is assigned to the segment. 

Corresponding expressions of the symbolic name which 
defines the length of the segment in words. Segments 
are assigned contiguously to form one block of data 
starting at location s^. The size of the block is equal 
to the surn of the sizes of trie segments. e; are eval- 
uated modulo 2^^-l and must be absolute. 

The associated symbolic name is assigned to the next 

segment which in effect assigns two names to that segment. 

omitted The length is assumed to be one computer word. 

symbolic Must be previously defined; can be assigned by an EQU 

name instruction. 

3.2.2 BZS 

This statement functions in the same way as the BSS, except that the specified storage 
locations are set to zero. 

The format is 

BZS S2(ej). 82(62). ..., Sj^(ejj) 
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Example: 



NAM 

NAM 3 LDA XYZl 

BSS NAM4(3) 

BZS NAM5(5) 

BSS NA M 1 , NA M2 ( S ) 

BSS NAM3 

BSS NAM6,(4) 

BSS NAM7 

EQU NAM8(4).NAM9(2) 

BZS NAM10(NAM8-NAM9) 

BSS NAM8(NAM]0-1) 

BSS LOC1(0).LOC2 



(Assign 3 words to NAM4) 
(Assign 5 words, set to zero, 

+ ^ "NTAllTCr\ 

(Assign 1 word to NAMl; assign 
9 words to NAM2) 
(Illegal; NAM3 already assigned) 
(Assign 1 word to NAM6, assign 
4 words to unnamed segment) 
(Assign 1 word to NAM7) 



(Assign 2 words, set to zero, to 

NAMIO) 

(Illegal; NAM8 already' assigned) 

(Assign the same word to LOCI and 

LOG 2) 



END 

3.2.3 COM 

The COM instruction names and defines segments in a block of storage common to more 
than one subprogram. 

The format is 

COM S2(e2^), S2(e2), . . ., Sn(en) 

s^ name Symbolic name which defines the first location of 

the named segment. 

omitted When omitted from a subfield, a segment is 

assigned with the length e but no name is assigned 
to the segment. 

Cj expression Corresponding expressions of the symbolic name 

which defines the length of the segment in words. 
Segments are assigned contiguously to form one 
block of data starting at location S]^. The size 
of the block is equal to the sum of the sizes of 
the segments. e^ are evaluated modulo 2^-1 and 
must be absolute. 



omitted 

symbolic 
name 



J. lie associated syniboiic iianit; is asaigned to the 
next segment which in effect assigns two names 
to that segm.ent. 

The length is assumed to be one computer word. 

Must be previously defined; can be assigned by 
an EQU instruction. 
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If a program includes more than one COM statement, they define consecutive segments 
of common storage in the order of their appearance. The area used b}' common 
storage is assigned by the loader at load time to locations outside the program area. 
Data in common storage cannot be preset by the ORG pseudo instruction. 



nple: 


NAM 






COM 


NAM4 


NAM3 


STA 


XYZl 




COM 


NAM7($1EF).NAM8 




EQU 


NAM1(6).NAM2(2) 




COM 


NAM5(NAM1-NAM2) 




COM 


NAM6(NAM3) 



(Illegal) 



END 



3.2.4 DAT 

The DAT instruction reserves area for common storage which is assigned within the 
program area and may be preset with data or instructions by using the ORG pseudo 
instruction (section 3.4.2). 

The format is 



DAT sj(ei), S2(e2), . . . . Sjj(e^) 

Si name 



Symbolic name which defines the first location of the 
named segment. 

omitted When omitted from a subfield, a segment is assigned 

with the length e but no name is assigned to the 
segment. 

expression Corresponding expressions of the symbolic name which 
define the length of the segment in words. Segments 
are assigned contiguously to form one block of data 
starting at location s-^. The size of the block is equal 
to the sum of the sizes of the segments. e^ ar.e 
evaluated modulo 2l5-i and must be absolute. 



omitted 

symbolic 
name 



The associated symbolic name is assigned to the next 
segment which in effect assigns two names to that 
segment. 

The length is assumed to be one computer word. 

Must be previously defined; can be assigned by an 
EQU instruction. 
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3.3 CONSTANT DECLARATIONS 

These pseudo instructions introduce constant values into the instruction sequence. 

3.3.1 ADC/ ADC* 

inserts the results in line. When ADC is followed by an asterisk, the evaluated 
address expressions are made relative to the current location counter. The reloca- 
tion type of the expression must be the same as that of the location counter. The 
value of the locations counter is subtracted from the value of the evaluated expression 
(16-bit one's complement arithmetic) and the result is the 16-bit address constant. 



The format is 



ADC e^,e2j (Cg), . . .,e^ 



s Symbolic name in the location field which is as- 

signed to the first constant in the address field. 

e. Numerical constant or address expression to 

be evaluated. The result is evaluated modulo 
2l5_i_ Bit 25 will be set if the expression is 
pnclos6d id oarentheses (l!idicatin<^ an 
indirect reference). The results corres- 
poncung' to ei , 89, . . . , e,, are stored in con- 
secutive storage locations. 

Note: Indirect addressing cannot be specified in the ADC* statement. 

3.3.2 ALF 

The ALF instruction translates a message into ASCII format. 
The format is 

s ALF n, message 

s Symbolic name in the location field which is as- 

signed to the first constant in the address field. 

n Unsigned integer specifying the number of 

words to be stored; 2n equals the number of 
characters. 

If n is an integer, 2n characters of the mes- 
sage are stored. Excess characters are 
treated as a remark. (The ALF statement, 
including the message, will not be processed 
beyond the 72nd character of the source 
image.) If the message is less than 2n char- 
acters, the unused portion of the specified 
area is blank filled. 
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Noninteger character which signals the end of 
the message. When n is a special terminating 
character, the storage of the message ter- 
minates the first time this character is 
encountered in the message if it occurs 
before the 72nd character. If the character 
just prior to n is the first character of a 
word, a blank is placed in the second char- 
acter to complete the word, 

A character message is stored into consecu- 
tive locations in the instruction sequence. 
The message is converted to ASCII charac- 
ters (Appendix C) and stored two 8-bit 
characters per word. 

The following typewriter control characters may be input with the ALF statement. 

Code Meaning Hexadecimal Value 

:R Carriage return D 

Horizontal tab 9 



7 

C 

B 

These codes are converted to a single output character with the corresponding hexa- 
decimal value and are counted as one character in determining the value of n, when 
n is an integer character count. A colon is an 8 to 5 key punch code with the ASCII 
value of 3Ajg. 

A symbolic name in the location field is assigned to the first word to the message. 

Example: 

The following source language statements 



L 


Line feed 


B 


Bell 


F 


Top of form 


V 


Vertical tab 



ALF 
ALF 
ALF 
ALF 



NAMl 
NAM2 
are translated into machine words. 



4, EXAMPLE 1 

. ,EXAMPLE2 

6, EXMP3:TEXMP4:R 

4.EXMP5 
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Character 



Location 



NAMl 



NAM2 



Left 



Right 



E 


X 


A 


M 


P 


L 


XT' 


1 


111 


X 


E 


X 


A 


M 


P 


L 


E 


2 


• 


A 


A 


A 


E 


X 


M 


P 


3 


tab 


E 


X 


M 


P 


4 


carriage return 


E 


X 


M 


P 


5 


A 


A 


A 



In this example A is a blank. Three dots indicate blanks fill in the words between 
EXAMPLE2 and EXMP3. This is because the special terminating character, ., 
does not occur in the message before the 72nd character. If, in the example, n is 
in column 13, then 25 words of blanks are used to fill the words between 
EXAMPLE2 and EXMP3. 



3.3.3 NUM 

The NUM instruction defines numeric constants. 
The format is 



NUM kj.kg.-.-k^ 



Symbolic name in the location which is assigned to the first 
constant in the address field. 



Specified integer constants stored into consecutive locations 
in the instruction sequence. Each constant may be a decimal 
integer within the range ±32767, or a hexadecimal integer 
preceded by a $ within the range ± 7FFF. The constant may 

b*^ O "! O"*^ '^ «^ ■ ■•'^ ■»+ ^^ r~t r\4- oi f*y^tn/-\ +V4o /^ *-m^ o + o M + TO o O O 1 1 i-v^ ^i /-I -t- r\ l-»ri 

v7 ol^i.x^^<u^ A.J. xb J.O xxv^ii ai.QL±\^\Af i>iA€ \^\ji.i.a vdixi. xo 0.0 1^ u.xxxv-v« bv^ t^y^ 

positive. When the sign is minus, the one's complement of 
the number is used. 
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Examples: 

The following source language statements 



NUM 
NAMl NUM 



1,2,3.$A 

+14, -10, -$13B, $7FF 



are translated into machine words. 

Location C ontents 

0001 
0002 
0003 
OOOA 



Location 

NAMl 



Contents 

OOOE 
FFF5 
FEC4 
07FF 



3.3.4 DEC 

The DEC instruction converts decimal constants into fixed-point binary. 

The format is 

s DEC kj, k2, . . . , kjj 

s Synnbolic name in the location which is assigned to the first constant 

in the address field. 



ki 



Specified integer constants stored into consecutive locations in the 
instruction sequence. It is a signed decimal integer followed by a 
decimal and/or binary scaling factor. The decimal scaling factor 
consists of the letter D followed by a signed or unsigned decimal 
integer. The binary scaling factor is the letter B followed by one or 
two signed or unsigned decimal digits. The form of a constant in 
the address field may be 

fDdBb 

which is equivalent to the algebraic expression 

f.10'^.2'' 

The fixed-point binary number resulting from the conversion 
must have a magnitude less than 2^5. If the result of scaling is 
greater than 2^^1, an error diagnostic is printed. 

A synnbolic name in the location field is assigned to the location of the first constant. 

Example: 

The source language statements 





DEC 


35D-1B6 


NAMl 


DEC 


-35B6 




DEC 


32760B-4 


NAM2 


DEC 


32761D-5B15,+625D-2B3 


NAM3 


DEC 


10D3 



are converted to machine words. 
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Location 

NAMl 

NAM2 
NAM3 



Contents of Bits 15 through 

0000000011100000 
11110111 00 111111 
OOOOOlllllllllll 
0010100111101111 
0000000000110010 
ooiOOlllOOQinnnn 



3.3.5 VFD 

The VFD (variable field definition) instruction assigns data to consecutive locations in the 
instruction sequence without regard for computer words. Data is stored in bit strings 
rather than word units; it may be numeric constants, ASCII characters, or expressions. 
A symbolic name in the location field is assigned to the first word of data. 



The format is 



s VFD 



"^l"l^^l'"^2"2^^2* 



, m n /v 
n n n 



m. 



name 



N 



X 



Symbolic name which defines the first location of the 
named segment. 

Specifies the mode of the data. 

When the value of the data is a numeric constant, the mode 
is specified as N and the number of bits must not be great- 
er than 16. If n is larger than necessary, the value is 
right justified in the field and the sign extended in the 
remaining high order bits. If n is less than is required, 
the value is truncated and the least significant bits are 
stored. The value, v, is a decimal integer or a hexadeci- 
mal integer preceded by a dollar sign. Integers may be 
signed or unsigned; if the sign is omitted, the number is 
assumed to be positive. A decimal number must be within 
the range ±32767 and a hexadecimal integer within the 
range ±7FFF. 

When V is string of characters, m must be A and n must 
be a multiple of 8. The number of characters in the string 
should be equal to n/8 including embedded blanks. The 
last character must be followed by a blank or a comma. 
The characters are converted to ASCII code and stored as 
in the ALF instruction (section 3.3. 2). 

When V is an expression, m must be X and n must be less 
than or equal to 16. If n is less than 16, the final value of 
the expression may be relocatable or absolute. It is eval- 
uated modulo 2-^5-1 =7FFFj^Q. If the final value is absolute 
and n exceeds the size required, the value is right justi- 
fied in the field. If absolute and n is less than the required 
size, the value is truncated and the least significant bits 
are stored in the field. If the final value is relocatable, 
n must equal 15 and the expression must be positioned so 
that it will be stored right justified at bit position of the 
computer word. 
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n. 

1 



If n equals 16, the expression must be absolute; it is 
evaluated using 16 -bit one's complement arithmetic. If a 
symbol is used in a 16-bit expression, bit 14 of the value 
of the symbol is extended to bit 15 and therefore the cal- 
culation of the value of the symbol is accurate only to 
214-1, For example, if the symbol A is equated to the 
value -1, the value of A in the symbol table is TFFE-^g 
but the value used in the 16-bit calcxilation of this 
symbol is FFFE^g. Numeric operands used in a 16-bit 
expression may be 16 bits in magnitude. 

Number of bits to be allocated 

Value of the data 



Examples: 

1. Source language statements 



NAM 
VFD 
BSS 



N3/l.X5/6-4,Al6/XY,X4/NAMl-NAM2 
NAM2(3),NAM1 



END 

result in machine words 
Word Contents 



15 






12 










7 



















1 











1 





1 


1 


1 












15 












7 






3 





1 





1 


1 





1 








1 1 









2. Source language statements 

NAM 

VFD N8/-1,A8/L,N1/0,X15/NAM1 

BSS NAMl 



END 

result in machine words 
Word Contents 



15 



1 1 



10 110 



15 14 



loc of NAMl 
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Source language statements 

NAM 

EQU A(-1).B(2) 

VFD X16/A.X16/B,X16/$7FFF*2 



END 
result in machine words 
Word Contents 



15 































1 


1 


1 


1 


1 


1 


1 


1 


1 


1 


1 1 


1 


1 


1 





15 






































































1 





15 































1 


1 


i 


1 


1 


i 


i 


i 


i 


i 


1 i 


1 


1 


i 


^1 



3.4 ASSEMBLER CONTROL 

The assembly process is controlled or modified by these pseudo instructions. A 
symbolic name in the location field is ignored except where specifically noted. 



3.4.1 EQU 

The EQU instruction equates each symbolic name to the expression value. 
The format is 

EQU s^{e^),s^{e^).. 

Symbolic name s^ is equated to the value e-j^. 



name 



s (e ) 
n n 



expression 



omitted 



Any symbolic operand used in the expression must 
be previously defined and not external to the 
subprogram in which the EQU statement appears, 
ej are evaluated modulo 2^°-l and must be absolute. 

The expression is assumed to be zero. 
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■nple: 


NAM 


EXAMPL 




PICKUP 


LDA 


XYZl 




NAM6 


ADD 


XYZ2 






EQU 


NAM3($4F). NAM4(-39) 






EQU 


NAM7(NAM6-1) 






EQU 


NAM8(STORE) 


(Illegal) 


STORE 


STA 


XYZ3 






EQU 


NAM9( STORE) 


(Legal) 



END 



3.4.2 ORG/ORG* 

The ORG statement specifies an address expression to which the current location 
counter is set. 

The format is 



ORG 



15 
e expression The expression, e, is evaluated modulo 2 -1 and 

the location counter is set to the resultant value. 

The value of the expression may be program or data 

relocatable, or absolute; if relocatable, it must be 

positive. Any symbolic operands in the expression 

must have been previously defined. 

The instructions following an ORG statement are assembled into consecutive locations 
beginning at the location of the evaluated address expression, e. This sequence may 
be changed by another ORG, or terminated by an ORG* statement. Within the range 
of a data relocatable ORG any reference to an external symbol is illegal. 

ORG* 

This instruction is used to return to the normal instruction sequence previously 
interrupted by an ORG. More than one ORG may be specified without an intervening 
ORG*; however, when an ORG* does occur, the location counter is reset to the value 
it had prior to the first ORG. 
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Example: 



NAMl 



BSS ORGi(iO),Oitu2, UUU3(5) 

ENA 



NAM2 JMP* NAM3 

ORG NAMl 

(sequence of code beginning at NAMl) 

ORG* 

(resume sequence of code at NAM2+1) 

NAM3 JMP* NAM4 

ORG ORG! 

(sequence of code beginning at ORGl) 

ORG ORGS 

(sequence of code beginning at ORGS) 

ORG* 

(resume seauence of rodp at NAM3 + 1) 



END 



3.4.3 IFA 

The IFA instruction assembles a set of coding lines only if a specified condition is true. 
The format is 



IFA 



ei.c.e2 

The symbolic name in the location field is used as an identifying tag only; 
it is not defined as a location symbol within the program. If specified, the 
first 2 characters of the identifier, s, must match the first 2 
characters of the symbolic name in the address field of the corre- 
sponding EIF, If s is blank in an IFA statement, it must also be 
blank in the corresponding EIF. 

The expressions ej^ and 63 are evaluated modulo 2^^-! and must 
result in an absolute value. Any symbolic name in either expression 
must have been previously defined. 

If the conditions specified by c exist between e\ and e2, the code is 
assembled; if the condition does not exist, the code following the IFA 
statement is skipped until a corresponding EIF statement is encountered. 
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The following conditions may be specified by c. 



Condition 


Meaning 


EQ 


«1 = ^2 


NE 


^1 * ^2 


GT 


^1 > ^2 


LT 


^1 < ^2 



3.4.4 EIF 

The EIF instruction signals the termination of an IFA or IFC instruction (section 4.1.4) 
when coding lines are skipped as a result of an untrue condition. When the condition 
in the IFA or IFC is true, EIF is ignored. 

1. he iormat is 

EIF s 

s The symbolic name, s, in the address field establishes the 

correspondence between an IFA or IFC and an EIF instruction. 
The first 2 characters of s must be the same as the first 2 
characters in the location field of the corresponding IFA or IFC. 
An EIF with a blank address field terminates an unlabeled IFA or 
IFC. 

Example: 

NAM 

LOCI BSS A(20),B(10),C(2) 

EQU NAM1(10),NAM4(B).NAM2(2) 

NAM3 IFA NAM1,EQ, NAM2+8 

OPl SAZ 1 

EIF NAM3 

IFA NAMl,GT,NAM2+8 

OP2 SAZ 2 

EIF 



END 
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OPl is assembled and OP2 is skipped if the value of NAMl equals the value of NAM2+8: 
OPl is skipped and OP2 is assembled if the value of NAMl is greater than the value of 
NAM2+8; both OPl and OP2 are skipped if the value of NAMl is less than thp valn^ of 
NAM2+8. 

3.4.5 OPT 

The OPT pseudo instruction signals the input of control options to the assembler. 
The format is 

OPT 
When OPT appears, the assembler requests input of control options by typing 

OPTIONS 

The following control options are entered in any order on the teletypewriter. Imbedded 
spaces and illegal characters are ignored. A carriage return signals the end of control 
options input. 

Option Meaning 

ij List output on slaaciaru iist device 

F PuiiCli ouiput uu biaiidarU punch uevice 

X Execute output on mass storage device 

M List called macro skeletons 

A Abandon all remaining assemblies and return control to operating system 

Ilu Input from unit lu. Reads instructions until the END statement is 

encountered, then returns to the standard input device; lu may be any 
ASCII or BCD input device. 

C List cross references at end of assembly listing, 

OPT is not a part of the source language program. It is used strictly for control of the 
assembler and has no code associated with it. 

OPT may precede any NAM instruction in any subprogram. If the first statement encoun- 
tered is not OPT, standard options are assumed until END is encountered. If OPT is 
encountered between the first statement of a program and the END statement, a diagnostic 
is issued. The standard options are L, P, X, and C. Chapter 5 describes output result- 
ing from the standard options. 

3.4.6 MON 

The MON instruction returns control to the operating system after the last subprogram has 
been assembled. 
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The format is 

MON 

MON may be used only after the END statement. The location and address fields are 
ignored. This statement is part of the source language program and is used strictly 
for control of the assembler; no code is associated with it. 

3.5 LISTING CONTROL 

The following pseudo instructions control the printing of assembly output. The location 
and address fields are ignored unless specified. 

3.5.1 NLS 

The NLS instruction inhibits list output. 

The format is 

NLS 

Normally list output is enabled initially until an NLS occurs and then remains inhibited 
until an LST instruction or the end of the program occurs. 

3.5.2 LST 

The LST instruction initiates list output after an NLS has inhibited it. 
The format is 
LST 

3.5.3 SPC 

The SPC instruction controls line spacing on the list output unit. 

The format is 

SPC e 

e Number of lines to be skipped; the expression is evaluated modulo 

215-1 and must be absolute. 

3.5.4 EJT 

The EJT instruction causes page ejection during printing of the list output. 
The format is 
EJT 
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MACROS 



An often used set of instructions may be grouped together to form a macro. Once a 
macro is defined, it may be used as a pseudo instruction. The 1700 Macro Assembler 
includes two types of macros. 



Programmer defined 



Library 



Macros which must be declared by MAC pseudo instructions 
immediately following the NAM image. Comment cards 
may, however, be placed anywhere in the macro definition. 

Definitions contained on the system library and may be 
called from any subprogram. 



4.1 MACRO PSEUDO INSTRUCTIONS 

These pseudo instructions are used only within a macro definition. 

4.1.1 MAC 

i lie ivI-riC labti uctiuii is 1 equii eu and iiciiiitis d macio and lisia its lui'iiiai parairietei'S. 
The location field contains the name used to call the defined macro. It may be any 
name which is not a machine or pseudo instruction. 



The format is 
s MAC 
s 

Pi 



P1.P2 Pn 

A symbolic name in the location field is assigned to the first word of 
the generated code. 

Symbolic names which are local to the macro definition and may be 
used anywhere else in the program without ambiguity. The formal 
parameters must conform to the following rules. 

They must be symbolic names of 1 or 2 characters 

The parameter list must not extend beyond the 72nd character 
of the line containing MAC 

The parameter list must terminate with a blank or the 72nd 
character of the line 

Each parameter in the list is separated from the next by a comma 
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4.1.2 EMC 

The EMC instruction is required and signals the end of a macro definition. A symbolic 
name in the location or address field is ignored. EMC is always the last instruction 
in a macro definition. 

The format is 

EMC 

4.1.3 LOC 

The LOC instruction is optional and allows the use of the same symbols in macros and 
programs to avoid doubly defined symbols. Symbols, other than formal parameters, 
that are local to the macro being defined are listed in this instruction. Local symbols 
have meaning only in the macro in which they are listed by LOC, thus allowing the 
same symbols to be used elsewhere in the program without ambiguity. 

The LOC instruction must immediately follow the MAC instruction. A symbol in the 
location field of the LOC instruction is ignored. 

The format is 

LOC S]^,S2,...»s« 

s. Local symbols in the address field which must conform to the 
following rules. 

They must be symbolic names of 1 or 2 characters 

The list cannot extend beyond the 72nd character of the line 
containing the LOC mstruction 

The list terminates with a blank or the 72nd character of the 
line 

Each symbol in the list is separated from the next by a comma 

No local symbol in the list may be the same as a formal 
parameter specified for the macro 

No more than 256 local symbols can be used m one program 

4.1.4 IFC 

The IFC instruction is optional and allows a set of instructions within a macro 
definition to be assembled only if a specified condition is true. This instruction 
is meaningful only within the range of a MAC pseudo instruction. 
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The format is? 

s IFC 

s The symbol in the location field is an identifying tag used to establish 

correspondence with the terminating EIF, An EIF terminates an IFC 
when the first two characters of the symbol in the address field of RTF 
are the same as the location symbol of the IFC, or when both symbols 
are blank and it is the first EIF encountered. 

a^ Must be a string of from 1 to 6 characters or a formal parameter 

specified in the MAC statement. The character string should not 
contain commas, blanks, or apostrophes. Two character strings are 
equal when they contain the same characters in the same position and 
are of the same length. Characters in excess of six are ignored. 

c Specified condition 

Condition Meaning 

EQ a^ = 3-2 

NE aj 1^ a2 

if the condition specified exists between aj and a2, the code is 
dbtoeiTibied; if not, the code fulluwiiiy the IFC i& skipped until <=t 
corresponding EIP^ pseudo instruction (section 3.4.4) is encountered. 

Source language examples of macro definitions and instructions are 
given in section 4.3.2. 

4.2 MACRO SKELETON 

A macro skeleton is the set of instructions within a macro definition that is the proto- 
type of the operations to be performed when the naacro is called. 

The instructions may be any machine or pseudo instruction except MAC, LOC, EMC, 
NAM, END, or MON. A macro skeleton may also contain macro instructions calling 
other macros. A macro skeleton may not contain a macro instruction calling itself. 
Formal parameters, enclosed in apostrophes, may appear anywhere in the instruction 
format of a prototype instruction. Local symbols defined by a LOC statement may be 
used anywhere in the macro skeleton; they also must be enclosed in apostrophes. The 
only legal use of the apostrophe in a macro definition is to enclose formal parameters 
or local symbols. Formal parameters that extend past the 72nd character into the 
sequence field are ignored. Formal parameters in a remark statement signaled by 
an * in column 1 are also ignored. 

In addition to the formal parameters specified in the MAC pseudo instruction, a special 
formal parameter (a period enclosed in apostrophes) may be used in the macro skele- 
ton. It is replaced by the instruction terminator of the calling macro instruction 
when a terminator is specified. 

Let A. B, C, . . . be distinct arbitrary macro skeletons. A may contain a macro 
instruction calling B, B a macro skeleton calling C, etc. Up to ten such successive 
macro calls are allowed by the assembler. Further successive calls are ignored. 



60361900B "^"^ 



Example: 








XYZ 


MAC 




P1.P2.P3.P4.P5 




LOG 




A 




LDA 




'PI' \ 




'P2' 




'P3' 1 




S'P4' 


Z 


'A'-*-l } Mac 




JMP' 


I 


r 1 


'A' 


ENA 





Macro skeleton 



EMC 

4.3 MACRO INSTRUCTION 

With a macro instruction, the code generated from the named macro is inserted in the 
instruction sequence beginning at the location of the macro instruction. 

The format is 

s N Pi.P2.....Pn 

s A symbolic name in the location field is assigned to the first word of 
the generated code, 

N Symbolic name of the macro in the operation code field. It is the name 
specified in the location field of the MAC statement of the macro definition 
it calls. The macro name may be followed by one of the special termi- 
nators +, -, or *. 

Pi Symbolic names which are local to the macro definition and may be used 
anywhere else in the program without ambiguity. 

4.3.1 PARAMETERS 

Actual 

The actual parameters must be listed in the same order as the formal parameters in 
the MAC statement. The list of actual parameters must conform to the following rules. 

Each parameter in the list is separated from the next by a comma. 

The list is terminated with a blank or the 72nd character unless the 72nd character 
is a comma. 

The list may be continued onto the next line; if so. the last parameter on the list 
is terminated by a comma and a blank or the 72nd character. 

The continuation line must contain the macro name in the operation code field. A 
symbolic name in the location field is ignored. 

An actual parameter containing embedded blanks or commas must be enclosed by 
apostrophes. 



4-4 60361900B 



The internal buffer for storage of actual parameters is 96 words long; this allows 
approximately three continuation lines. If the buffer overflows, an error message is 
given. 

Example: 

The macro defined in the previous example as XYZ could be called by the following 
macro instruction. 

TAG! XYZ* SYMBl.STA. 'SYMB2,I', 

XYZ* Q. LABELl (Continuation line) 

This macro instruction would generate the following code starting at location TAGl. 
TAGl 



fnn 



LDA 


SYMBl 


STA 


SYMB2.I 


SQZ 


[nn-*-l 


JMP* 


LABELl 


ENA 


1 



NOTE 
[nn is a unique identifier assigned at assembly time. 



Null 



Actual parametei t> may be omitted from a macro instrucTion. An omitted 'nulP 
parameter in the middle of the list is indicated by its terminating comma only. 
Parameters at the end of the list may be omitted with no indication. 

Example: 

XYZ MAC P1.P2,P3.P4.P5. P6 

The macro instruction with P2. P4, and P6 omitted in the actual parameter list 
would be: 

XYZ MUl. .SYMB5.,3 

Empty fields are allowed in all machine and pseudo instructions with the following 
exceptions. 

(n must be specified) 

(If e is specified, s 
must be specified) 

(c must be specified) 

Actual parameters to be inserted into the value of a VFD instruction using mode A 
must agree with the number of characters specified. A null actual parameter can 
cause an error in the generated code unless the VFD allows for null parameters. 



ALF 


n, message 


EQU 


s(e) 1 


COM 


s(e) 


DAT 


s(e) 


IFA 


ej.c, e2 1 


IFC 


ai-c.a2 
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Example: 
X 



MAC 
VFD 



P.Q.R 

A8/'P',A8/'Q'.A8/'R' 



For the macro defined, the calling macro instruction must specify each actual parameter 
as 1 character long. If an actual parameter is more than 1 character, an error message 
is given. However, if an actual parameter is omitted, a code is generated and an error 
results. 



X 

VFD 



A,,B 
A8/A,A8/,A8/B 



(Q is omitted) 
(Code generated) 



If actual parameters might be omitted, the VFD instruction in the macro skeleton should 
include empty subfields for each character. 

Example: 

The macro definition should be written: 

X 



MAC 
VFD 



P.Q.R 
A8/'P',,A8/'Q',,A8/'R', 



A calling sequence with no actual parameters generates the following code and no 
error results. 



VFD 



A8/,,A8/,,A8/, 



4.3.2 EXAMPLES 

The following examples show macro definitions and the code generated by macro instruc- 
tions calling the defined macros. 



1. 



Macro Definition 



XYZ MAC 


P1,P2,P3,P4, P5,P6 


LDQ 


=N'P5', 'P6' 


•P4' LDA 


•P3' 


•PI' 


•P2' 


ADD 


SYMBl 


IFA 


'P5', NE,0 


11 IFC 


ipi',EQ,MUI 


STA 


SYMB3 


LDA 


SYMB2 


EIF 




EIF 


11 


EMC 




Macro Instruction 





CALLl 



XYZ 



MUI, 'SYMB4, r, SYMB5, HERE, 3, 1 
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Generated Code 



b. 



CALLl LDQ 


=N3,I 


HERE LDA 


SYMB5 


MUI 


SYMB4, 1 


ADD 


SYMBl 


IFA 


3, NE, 


li IFC 


MUI, EQ, MUI 


STA 


SYMB3 


LDA 


SYMB2 


EIF 




EIF 


11 


Macro Instruction 





(Condition satisfied) 
(condition satisfied) 
(Assembled) 
(Assembled) 



CALL2 XYZ 

Generated Code 



DVI, SYMB7, 'SYMB8, 1', THERE, 2 



CALL2 


LDQ 




=N2. 




THERE 


LDA 

DVI 

ADD 




SYMB8,I 

SYMB7 
SYMBl 






IFA 




2,NE,0 


(Condition satisfied) 


11 


IFC 




DVI, EQ, MUI 


(Condition not satisfi 




STA 




SYMB3 


(Not assembled) 




LDA 




SYMB2 


(Not assembled) 




EIF 










EIF 




11 




Macro Definition 








A MAC 


P1,P2 


,P3. 


P4 




11 IFC 


*.EQ. 


•PI' 






LDA 


'P2' 








EIF 


11 








12 IFC 


*, NE, 


'PI' 






LDA 


'P3' 








EIF 


12 








STA 


'P4' 








EMC 










a. Macro Instruction 









*, NAMl, NAM2, NAM3 



Generated Code 



11 


IFC 


*, EQ, * 




LDA 


NAMl 




EIF 


11 


12 


IFC 


*, NE,* 




LDA 


NAM2 




EIF 


12 




STA 


NAM 3 



(Condition satisfied) 
(Condition not satisfied) 
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3. Macro Definition 



JAN 



MAC 


SY 


IFC 


*,EQ, '.' 


SAZ 


1 


EIF 




IFC 


*,NE, '. ' 


SAZ 


2 


EIF 




JMP'. ' 


•SY' 


EMC 





Macro Instruction 

JAN* 

Generated Code 

IFC 
SAZ 
EIF 
IFC 
SAZ 
EIF 
JMP* 

Macro Instruction 

JAN 

Generated Code 



SYMBl 



*, EQ, * 
1 



*, NE, * 
2 

SYMBl 



SYMB2 



(Condition satisfied) 

^^ « k^ O C &XAfc^^^ %.«/ 

(Ignored) 

(Condition not satisfied) 
(Not assembled) 
(Skip terminated) 





IFC 




•S EQ, 


(Condition not satisfied) 




SAZ 




1 


(Not assembled) 




EIF 






(Skip terminated) 




IFC 




*, NE, 


(Condition satisfied) 




SAZ 




2 


(Assembled) 




EIF 






(Ignored) 




JMP 




SYMB2 




Macro Definition 








IFEXMP MAC 


PI 








Z IFC 


*, EQ, 


'PI' 






NUM 


2 








EIF 


Z 








Y IFC 


*. NE, 


'PI' 






X IFC 


O.EQ, 


'PI' 






NUM 


1 








EIF 


X 








Y IFC 


0,NE. 


•PI' 






NUM 











EIF 


Y 








EMC 










a. Macro Instruction 










IFEXMP 


=;< 
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Generated Code 



z 




IFC 


*,EQ,* 






NUM 


2 






EIF 


Z 


Y 




IFC 


*, NE, * 


X 




IFC 


0, EQ, * 






NUM 


1 






EIF 


X 


Y 




IFC 


0, NE, * 






NUM 









EIF 


Y 


b. Macro Instruction 








IFEXMP 





Generated Code 




Z 




IFC 


>:<, EQ, 






NUM 


2 






EIF 


Z 


Y 




IFC 


=:', NE, 


X 




IFC 


0, EQ, 






NUM 


1 






EIF 


X 


Y 




IFC 


O.NE.O 






NUM 









EIF 


Y 


c. Macro Instruction 








IFEXMP 




Generated Code 




Z 




IFC 


=!', EQ, 






NUM 


2 






EIF 


Z 


Y 




IFC 


*,NE, 


X 




IFC 


O.EQ, 






NUM 


1 






EIF 


X 


Y 




IFC 


0,NE, 






NUM 









EIF 


Y 


5. Macro Definitions 




DEPTH 1 


MAC 


A 






DEPTH2 'A ', PARAM 1 




EMC 






DEPTH2 


MAC 


A,B 






DEPTHS 'A', PARAM2 




EMC 






DEPTHS 


MAC 


C,D 






LDA 


'C 






STA 


'D' 






EMC 
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(Condition satisfied) 

(Condition not satisfied) 
(Not assembled) 

(Not assembled) 
(Not assembled) 
(Not assembled) 
(Skip terminated) 



(Condition not satisfied) 
(Not assembled) 
(Skip terminated) 
(Condition satisfied) 
(Condition satisfied) 
(Assembled) 

(Condition not satisfied) 
(Not assembled) 
(Skip terminated) 



(Condition not satisfied) 
(Not assembled) 
(Skip terminated) 
(Condition satisfied) 
(Condition not satisfied) 
(Not assembled) 
(Skip terminated) 
(Condition satisfied) 
(Assembled) 
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Macro Instruction 



6. 





DEPTHl 


SYMBl 


Generated Code 






DEPTH2 


SYMBl.PARAMl 




DEPTHS 


SYMBl. PA RAM2 




LDA 


SYMBl 




STA 


PARAM2 


Macro 


Definition 




B 


MAC 


A,B.C.D,E,F.G,H,I.J,K 




LOC 


LO 




ALF 


'A', 'B'A ERROR 




VFD 


'C'/'D',A16/'E'.,,A32/TEST 




IFC 


'G'.EQ. SKIP 




LDA 


'H' 




EIF 




'I' 


INA 


'J' 




'K' 


1 




SAN 


'LO' 




ENA 


-1 


'LO' 


STA 
EMC 


'F' 


Macro 


Instruction 






B 


4. 1.N4. -l.XY. 'TEMP.I'.SKI 




B 


NAM2. lO.NOP 


Generated Code 






ALF 


4.1 A ERROR 




VFD 


N4/-1,AI6/XY...A32/TEST 




IFC 


SKIP. EQ. SKIP 




LDA 


TEMP. I 




EIF 




NAM2 


INA 


10 




NOP 


1 




SAN 


[nn 




ENA 


-1 


[nn 


STA 


TEMP. I 



4.4 MACRO LIBRARY 

LIBMAC is released as a separate library macro preparation routine. Input to this routine 
is in the form of a set of macro definitions, each starting with a MAC statement and ending 
with an EMC statement. The complete set of macro definitions to be input to the library 
is terminated by the characters ENDMAC starting in column 1 of the source image. 

The library macro preparation routine outputs two files on the standard I/O device for 
I binary output. One contains a macro directory; the other contains the macro skeletons. 
The routine checks for errors and prints an error message along with the line containing 
the error. 
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Binary output is in two sections, the macro skeleton file and the macro directory file. 
Alter the skeleton file has been output, the message IvIACSKL END is output on the 
typewriter and a carriage return must be typed to start output of the macro directory. 

T" Vl o ^n + T*tlTt" "filf^c Q-K»o r-\l iar>oH r\y-t +li£i i-w^ <-r-K>'i v-v-i 1 iVm^q r'Tr i r» +H'''-' -^^ toi-v-. r-, « ^^4- P '.1 ^ ^ ,-i^i*-.rt- +l-io 

system initializer or library editor of the 1700 MSOS. 

1. lie iiurary euiuor oi tue 1700 operating system is used to put the macros on the 
program library. 

The control statement 

*N, MACROS, . , B 
places the macro directory file on the program library. 
The control statement 

*N. MACSKL. . . B 
places the macro skeletons on the program library. 
Refer to the 1700 MSOS Reference Manual for further information. 
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ASSEMBLER OUTPUT 



c 1 rrMUTDm r\DTi/Muc 



Four standard options determine the type of output from the assembler. All four are 
automatically selected if no OPT statement is encountered before the first NAM. 

Option Meaning 

P Relocatable binary output on standard output unit. 

X Load and go; execute output loaded on a mass storage device. 

L List output on standard list unit. 

C List cross-references at end of assembly listing. 

5.1.1 P OPTION 

Rplocatable binary output is selected by the P option. The format is described in the 

■-nr. -\TCOC -D .,<■,-,„,". ,-,t. "i T, -,,-,, .-,T 

The standard output binary device is used for relocatable binary inform.ation. If the binary 
output device is magnetic tape, the final relocatable program terminates with an EOL 
record, *T. If the binary output device is paper tape, a blank trailer terminates each 
assembly. 

5.1.2 X OPTION 

If the X option is selected, relocatable binary output is placed on the mass storage unit 
for subsequent loading and execution as described in the 1700 MSOS Reference Manual. 

5.1.3 L OPTION 

The L option results in an assembly listing described as follows. 

With the OPT pseudo instruction (section 3. 4. 5) any or all of the preceding options may 

be omitted. OPT also provides options for listing macro skeletons and abandoning assembly. 

5.1.4 C OPTION 

The C option produces a cross-reference list which is printed at the end of the assembly 
list (as described in section 5. 2. 2), 
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5.2 ASSEMBLY LISTING 

The assembly list, output to standard list output device, consists of 18 columns of 
information related to the source statement, followed by a maximum of 80 columns 
listing the source statement. 

Each page has a header containing the program name, page number, and date. 

C ontents 

Card number; truncated from 5 to 4 decinial digits 

Space 

Relocation designator for location 

P Program relocation 

O Data relocation 

Location in hexadecimal 

Space 

Machine word in hexadecimal 

Relocation designator for word 

P Program relocation 

-P Negative program relocation 

C Common relocation 

-C Negative common relocation 

D Data relocation 

-D Negative data relocation 

X External 



Column 




1 through 


4 


5 




6 




7 through 


10 


11 




12 through 


15 


16 through 


17 



18 
19 through 98 



blank Absolute 
Space 

Input source statement 



Following the assembly list, the lengths of the program, common, and data are given in 
hexadecimal and decimal values, 

PGM = 0155(341) COM = 2BE(702) DAT = 0000(0) 

The data length includes those areas reserved by DAT pseudo instructions. 

5.2.1 ERROR LISTING 

A list of errors occurring in passes 1 and 2 precedes the program listing on the standard 
list I/O unit. If the L option is selected, errors in pass 3 precede the source line on 
the list output. A decimal error count is printed at the end of each subprogram. If L is 
not selected, error messages are output on the standard comment unit. 
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Format for pass 1 and 2 error messages: 

C olumn Contents 

1 and 2 ** 

3 through 6 4-digit line number 

6 and 7 ** 

8 and 9 2-character error code 
10 through 19 ^^i^** =;:=!=**** 

Format for pass 3 error messages: 

Column Contents 

1 through 6 =:<***** 

7 and 8 2-character error code 
9 through 18 **=!==i:=:=*=;=*** 

The prror r.ndp.s and thpir meanincrs are cfiven in Ai'>Deridix D. 

5.2.2 CROSS-REFERENCE LISTING 

Cross-references are listed at the end of an assembly listing if the option C was specified 
by the user. Cross-references will also be listed if no OPT statement was found, since 
the C option is a default option. 

The cross-references are divided into four functional parts: 

1. Equivalences 

2. Symbols 

3. Externals 

4. Symbols in alphabetical order 

If cross-references are to be listed and there is not enough core to process all four parts 
of the cross-references listing, then the assembler attempts to sort the symbol table 
alphabetically. If there is not enough core to sort the symbol table alphabetically, the 
symbol table is dumped. 

The equivalences, symbols, and externals are listed according to the line number at which 
they are defined. In addition to the definition line number, the value or address and the 
line numbers of all references to that symbol are given. The list of symbols in alphabetical 
order includes all the symbols in the program. The number following each symbol is the 
corresDondine definition line. 
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5.2.3 SAMPLE PROGRAM 

The following source program results in the assembly listing in section 5.2.4. 





NAM 


TEST2 ERS MACRO EXAMPLEX 


XYZ 


MAC 


P1,P2,P3.P4.P5.P6 




LDQ 


=N'P5'.'P6' 


'P4' 


LDA 


'P3' 




'PI- 


'P2' 




ADD 


SYMBl 




IFA 


'P5',NE.O 


11 


IFC 


'Pl'.EQ. MUI 




STA 


SYMB3 




LDA 


SYMB2 




EIF 






EIF 


11 




EMC 




MACRO 


MAC 


P1.P2.P3,P4.P5,P6 




LOC 


A 




LDA 


'PI' 




'P2' 


'P3' 




S'P4'Z 


•A'-*-l 




JMP'P5' 


'P6' 


•A' 


ENA 
EMC 


1 




MACRO 


SYMBl, STA. 'SYMB2.I', 




MACRO 


Q. *, LABELl 


SYMBl 


ADC 





SYMB2 


ADC 







XYZ 


MUI..SYMB5,.3 


SYMB5 


ADC 





CALLl 


XYZ 


MUI. 'SYMB4. 1'. SYMB5. HERE, 3, 1 


SYMB4 


ADC 





CALL2 


XYZ 


DVI, SYMB7. 'SYMB8, I', THERE. 2 


SYMB8 


ADC 





SYMB7 


ADC 

END 






5.2.4 SAMPLE LISTING 

The following assembly listing is output from the assembly of the source program in section 
5.2.3, 

0001 
0002 
0003 
0004 
0005 
0006 
0007 





NAM 


TEST2 ERS MACRO EXAMPLEX 


XYZ 


MAC 


P1,P2,P3.P4,P5, P6 




LDQ 


=N'P5', 'P6' 


'P4' 


LDA 


'P3' 




'PI' 


'P2' 




ADD 


SYMBl 




IFA 


'P5'.NE.0 
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0008 



0009 






0010 






0011 






0012 






0013 






0014 






0015 






0016 






0017 






0018 






0019 






0020 






0021 






0022 






0023 






0023 


POOOO 


C800 




POOOl 


0006 


0023 


P0002 


6900 




P0003 


0005 


0023 


P0004 


0141 


****=! 


"!=UD*-'"i 


:;;c:^c;;s;;ii;c;;ij;< 


>I: iji J[i >l: ;| 


'*RL**=! 


:**>;:>:o;:*;i; 


0023 


P0005 


1000 


0023 


POOOG 


OAOl 


0024 


P0007 


0000 


0025 


P0008 


0000 


0026 






0026 


P0009 


EOOO 




POOOA 


0003 


0026 


POOOB 


C800 




POOOC 


0009 


0026 


POOOD 


2400 




POOOE 


0000 


0026 


POOOE 8800 




POO 10 


FFE6 


jj:j:<s:<>x**j********** 


0026 


POOH 


6400 




P0012 


0000 


0026 


P0013 


C800 




P0014 


FFE3 


0027 


P0015 


0000 


0028 






0028 


POO 16 


ElOO 




P0017 


0003 


0028 


P0018 


C800 




P0019 


FFE8 


0028 


POOIA 


2 900 




POOIB 0007 


0028 


POOIC 


8800 




POOID FFE9 


******J****>K*>;c!U>K>,'< 


0028 


POOIE 


6400 




POOIF 0000 


0028 


P0020 


C800 




P0021 


FFE6 


0029 


P0022 


0000 



11 


IFC 


'Pl'.EQ. MUI 




STA 


SYMB3 




LDA 


SYMB2 




KIF 






EIF 


11 




EMC 




MACPvO 


MAC 


P1.P2.P3,P4. P5, P6 




LOG 


A 




LDA 


'PI' 




'P2' 


'P3' 




S'P4'Z 


'A'-*-l 




JMP'P5' 


'P6' 


•A' 


ENA 
EMC 


1 




MACRO SYMB1.STA.'SYMB2.I 




MACRO 


Q. =:% LABEL! 



SYMBl 



ADC 
XYZ 



MUI. .SYMB5..3 



SYMB5 
CALLl 



ADC 
XYZ 





MUI, 'SYMB4, 1'. SYMB5. HERE. 3. 1 



SYMB4 ADC 
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0030 




CALL2 


XYZ 


D 


0030 


P0023 FOOO 
P0024 0002 








0030 


P0025 C900 
P0026 0005 








0030 


P0027 3800 
P0028 0004 








0030 


P0029 8800 
P002A FFDC 








0031 


P002B 0000 


SYMB8 


ADC 





0032 


P002C 0000 


SYMB7 


ADC 





0033 






END 





DVI. SYMB7. 'SYMB8, 1' . THERE. 2 
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MNEMONIC INSTRUCTION CODES 



MACHINE INSTRUCTIONS 

There are six classes of machine instruction codes. 

Storage reference. Group A 

Storage reference. Group B 

Register 

Shift 

Skip 

Interregister transfer 

Storage Reference Instructions 

Operation Code Definition 

Group A 



LDA 
LUQ 
ADD 
SUB 
ADQ 
AND 
EOR 
MUI 
DVI 



Load A register 

Load Kci register 

Add to the A register 

Subtract from A register 

Add to Q register 

Perform logical AND with A register 

Perform logical exclusive OR with A register 

Multiply integer with A register 

Divide integer into A register 



Group B 



STA 
STQ 
JMP 
RTJ 
RAO 
SPA 



Store A register 

Store Q register 

Unconditional jump 

Return jump 

Replace add one in storage 

Store A register, return parity to A register 
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Register Instructions 



Operation Code 


Definition 


SLS 


Selective stop 


INP 


Input to A register 


OUT 


Output from A register 


ENA 


Enter A register 


ENQ 


Enter Q register 


INA 


Increase A register 


INQ 


Increase Q register 


NOP 


No operation 


EIN 


Enable interrupt 


UN 


Inhibit interrupt 


EXl 


Exit interrupt state 


SPB 


Set program protect bit 


CPB 


Clear program protect bit 


Shift Instructions 




ARS 


A right shift 


QRS 


Q right shift 


LRS 


Long right shift (Q and A combined) 


ALS 


A left shift 


QLS 


Q left shift 


LLS 


Long left shift (Q and A combined) 


Skip Instructions 





SAZ 
SAN 
SAP 
SAM 
SQZ 
SQN 
SQP 
SQM 
SWS 
SWN 
SOV 



Skip if A=0 

Skip if A/0 

Skip if A is positive 

Skip if A is negative 

Skip if Q=0 

Skip if Q^O 

Skip if Q is positive 

Skip if Q is negative 

Skip if switch is set 

Skip if switch is not set 

Skip on overflow 
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Operation Code 



Definition 



SNO 
SPE 
SNP 

CDtr 
kj J. 1.' 

SNF 



Skip on no overflow 
Skip on storage parity error 
Skip on no storage parity error 
Skip on program protect fault 
Skip on no program protect fault 



Inter-Register Transfer Instructions 



SET 

CLR 

TRA 

TRM 

TRQ 

TRB 

TCA 

TCM 

Trn 

TCB 

AAM 

AAQ 

AAB 

EAM 
EAQ 
EAB 

LAM 
LAQ 
LAB 

CAM 

CAQ 

CAB 



Set specified register to ones 

Clear specified register to zeros 

Transfer A to specified register 

Transfer M to specified register 

Transfer Q to specified register 

Transfer both (Q+M) to specified register 

Transfer complement of A to specified register 



3 pC K_ ii 



^CgloLcX' 



Transfer complement of both (Q+M) to specified register 

Transfer arithmetic sum of A and M to specified register 

Transfer arithmetic sum of A and Q to specified register 

Transfer arithmetic sum of A and both (Q+M) to specified 
register 

Transfer exclusive or of A and M to specified register 

Transfer exclusive or of A and Q to specified register 

Transfer exclusive or of A and both (Q+M) to specified 
register 

Transfer logical product of A and M to specified register 

Transfer logical product of A and Q to specified register 

Transfer logical product of A and both (Q+M) to specified 
register 

Transfer complement of logical product of A and M to 
specified register 

Transfer complement of logical product of A and Q to 
specified register 

Transfer complement of logical product of A and both (Q+M) 
to specified register 



Note: + indicates an inclusive OR. 
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PSEUDQ INSTRUCTIONS 

There are six classes of pseudo instructions. 

Subprogram linkage 
Data storage 
Constant declaration 
Assembler control 
Listing control 
Macro definition 



Subprogram Linkage 



Operation Code 

NAM 
END 
ENT 
EXT 

EXT* 



Definition 

Identify source language subprogram 
End source language subprogram 
Designate internal entry point nam.es 
Designate external entry point names 
Designate relative external entry point names 



Data Storage 



BSS 
BZS 
COM 
DAT 



Define a block of storage starting at symbol 
Define a block of zero storage 
Define a block of common storage 
Define a block of data storage 



Constant Declarations 

ADC 
A DC-' 

ALF 
NUM 
DEC 
VFD 



Store address constants 

Store relative address constants 

Store an alphanumeric message 

Store numeric constants 

Convert and store decimal constants m fixed point format 

Variable field definition and storage 
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Assembler Control 



Operation Code 

EQU 
ORG 
ORG* 

IFA 
EIF 
OPT 
AION 



Definition 

Equate symbols to addresses 

Defines orifin for assemhlv nf instrnntinns fnllowincr ORG 

Terminate ORG 

If condition is true assemble following instructions 

Terminate IFA (or IFC macro pseudo instruction) 

Signal input of control options 

Return control to operating system 



Listing Control 



NLS 
LST 
SPC 

E.JT 



Inhibit list output 

Resume list output after NLS 

Space lines on list output 

f'^ject page on list output 



Aiaci'o iJeiinition 



MAC 
EMC 
LOC 
IFC 



Specify name of macro 

End macro definition 

I3efine local symbolic labels 

If condition is true assemble following instructions 
in macro 
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PROGRAMMING CONSIDERATIONS B 



CODING TECHNIQUES 

The following limitations should be observed when coding programs to run under 1700 MSOS 
Version 4 in 65K mode. 

All 16 bits of an address word are needed in order to address all of available core. 
This means that bit 15 can no longer be used to indicate the conditions it can be used 
for in a 32K mode system. 

Multilevel indirect addressing cannot be used in 6 5K mode which signifies that instruc- 
tions of the following form can no longer be used. 

ADC (TAG) 

LDA+ (TAG) 

If relative addresses are generated, the following instruction is allowed. 

LDA (TAG) 

Ihe instruction 

ADC (TAG) 

is allowed in 65K mode if there are no storage instructions that make indirect reference 
to this location and the program containing this expression will never be loaded into 
part 1 of a 65K system. 
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ASCII CODES 



The 1963 Cbntrol Data Subset of ASCII (CDC-STD 1. 10.003, Revision C) is used by the 
1700 Macro Assembler. ASCII code uses eight bits; the eighth bit, which is always zero, 
is omitted in the following table. 



ASCII 


Bit 


Hexadecimal 


Symbol 


Configuration 
000 0000 


Number 


NULL 





SOM 


000 


0001 


1 


EGA 


000 


0010 


2 


EOM 


000 


0011 


3 


EOT 


000 


0100 


4 


WRU 


000 


0101 


5 


RTJ 


000 


Olio 


6 


BELL 


000 


0111 


7 


FEq 


000 


1000 


8 


HT/SK 


000 


1001 


9 


LF 


000 


1010 


A 


^TAB 


000 


1011 


B 


FF 


000 


1100 


C 


CR 


000 


1101 


D 


SO 


000 


1110 


E 


SI 


000 


1111 


F 


DCq 


001 


0000 


10 


DC^ 


001 


0001 


11 V 


DC2 


001 


0010 


12 


DC3 


001 


0011 


13 


DC^ (STOP) 


001 


0100 


14 


ERR 


001 


0101 


15 


SYNC 


001 


Olio 


16 


LEM 


001 


0111 


17 



Meaning 

Null /idle 

Start of message 

End of address 

End of message 

End of transmission 

Who are you 

Are you 

Audible signal 

Format effector 

Horizontal tab/skip (punched card) 

Line feed 

Vertical tabulation 

Form feed 

Carriage return 

Shift out 

Shift in 

Device control/data link escape 

Device controls 

Device control /stop 
Error 



oynciirouuus luie 
Logical end of media 
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ASCII 


Bit 


Hexadecimal 




Symbol 


Config 
001 


uration 
1000 


Number 


Meaning 


^0 


18 




Si 


001 


1001 


19 




^2 


001 


1010 


lA 




h 


nn 1 


1011 


IB 


Information separators 


^4 


001 


1100 


IC 




S 


001 


1101 


ID 




^6 


001 


1110 


IE 




^7 


001 


nil 


IF 




A 


010 


0000 


20 


Word separator (space) 


I 


010 


0001 


21 


Exclamation point 


tr 


010 


0010 


22 


Quotation mark 


# 


010 


0011 


23 


Number 


$ 


010 


0100 


24 


Dollar sign (hexadecimal) 


% 


010 


0101 


25 


Percent 


& 


010 


Olio 


26 


Ampersand 


' (APOS) 


010 


0111 


27 


Apostrophe 


( 


010 


1000 


28 


Left parenthesis 


) 


010 


1001 


29 


Right parenthesis 


* 


010 


1010 


2A 


Asterisk 


+ 


010 


1011 


2B 


Plus 


, (Comma) 


010 


1100 


2C 


Comma 


- 


010 


1101 


2D 


Minus 


. 


010 


1110 


2E 


Decimal point or period 


/ 


010 


nil 


2F 


Slash 





oil 


0000 


30 1 




1 


on 


0001 


31 




2 


on 


0010 


32 




3 


on 


0011 


33 




4 


on 


0100 


34 


Numbers 


5 


on 


0101 


35 




6 


on 


Olio 


36 




7 


on 


0111 


37 




8 


on 


1000 


38 




9 


on 


1001 


39 




: 


on 


1010 


3A 


Colon 


i 


on 


1011 


3B 


Semi-colon 
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ASCII 



Bit 



Hexadecimal 



Symbol 


Corifi^uration 


Number 


ivleaning 


^ 


mi 


1100 


3C 


T „™^ 4.T 

i-jCOO LlldLl 


= 


on 


1101 


3D 


Equals 


> 


on 


1110 


3R 


Greater than 


9 


on 


nil 


3F 


Question mark 


@ 


100 


0000 


40 


Each 


A 


100 


0001 


41 




B 


100 


0010 


42 




C 


100 


0011 


43 




D 


100 


0100 


44 




E 


100 


0101 


45 




F 


100 


Olio 


46 




G 


100 


0111 


47 




H 


100 


1000 


48 




I 


100 


1001 


49 




.1 


100 


1010 


4 A 




K 


100 


101 1 


4B 




L 


100 


1100 


4C 




M 


100 


1101 


4D 


Letters 


N 


100 


1110 


4E 




O 


100 


nil 


4F 




P 


101 


0000 


50 




Q 


101 


0001 


51 




R 


101 


0010 


52 




S 


101 


0011 


53 




T 


101 


0100 


54 




U 


101 


0101 


55 




V 


101 


Olio 


56 




w 


101 


0111 


57 




X 


101 


1000 


58 




Y 


101 


1001 


59 




z 


101 


1010 


5A 




I 


101 


1011 


5B 


Left bracket 


\ 


101 


1100 


5C 


Reverse slant 


1 


101 


1101 


5D 


Right bracket 
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ASCII 

Symbol 


Bit 
Configuration 

101 1110 


Hexadecimal 
Number 


Meaning 


t 


5E 


Up arrow {exponentiation 


*- 


101 


nil 


5F 


Left arrow (replaced by) 


ACK 


111 


1100 


7C 


Acknowledge 


Q 


111 


1101 


7D 


Unassigned control 


ESC 


111 


1110 


7E 


Escape 


DEL 


111 


nil 


7F 


Delete/idle 



The numbers between 5F and 7C have no ASCII code assigned to them. 
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MACRO ASSEMBLER ERRORS 



ivi£;aaAUii 



**xxxx**yy********** 



*****>l<yy******>lt*>le* 



ABS BASE ERR 



•■iJ^ 



**EX 



INPUT ERROR 
**LB 

MASS STORAGE OVERFLOW 
**MC 



SIGNIFICANCE 

Format for pass 1 and 2 error messages 

Where: xxxx is a 4-digit line number. 

yy is a 2 -character error code 

(explained below). 

Format for pass 3 error messages. If the L option 
is selected, errors in pass 3 precede the source line 
on the list output. If L is not selected, error mes- 
sages are output on the standard comment unit. 

Assembler was loaded at a different location from 
where it was absolutized. 

uoubie defined symbol; a name in: 

• J. lie xuv^aiiuii 1J.CXU ui ct iiicujiiiiie iiiaiiuuiiuii 

or an ALF, NUM, or ADC pseudo instruc- 
tion; or 

• The address field of an EQU, COM, DATA, 
EXT, BSS or a BZS pseudo instruction. 

Illegal expression, either: 

• No forward referencing of some symbolic 
operands; or 

• No relocation of certain expression values; or 

• A violation of relocation; or 

• Illegal register reference; or 

• A symbol other than Q, 1, or B is specified. 
An error was returned by driver when doing a Read. 
Numeric or symbolic label contains illegal character. 

rni l_l 1 j_ :^ I 

Not enough room for input image on mass storage. 
Macro call error, 

• Illegal parameter list 

• No continuation card where one was indicated. 
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MESSAGE 

**MD 
*=KMO 

*=i:OP 



**ov 



^Jjtpp 



^*RL 



**SQ 



**UD 



SIGNIFICANCE 

Macro definition error. 

Overflow of load-and-go area; affects only X option. 

Missing or misplaced NAM statement. 

Illegal operation code, either: 

• Illegal symbol in operation code field; or 

• Illegal operation code terminator. 

Numeric constant or operand value is greater than 
allowed. 

Error in previous pass of compilation assembly. See 
output page immediately preceding first page of listing 
for pass 1 or pass 2 error message. 

Illeg3il relocation, either: 

• Violation of relocation; or 

• Violation of a rule for instructions that 
requires the expression value to either 

be absolute or have no forward referencing 
of symbolic operands. 

Sequence error — Tags instructions with sequence 
numbers that are out of order. This is not fatal and 
is not counted in the number of errors reported at 
the bottom of the symbol table. 

An undefined symbol in an address expression. 
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INDEX 



Absolute addressing 2-1,3 
ADC/ADC* 3-7; A-4 
Address expression 1-3,5 
Address field 1-2 
Address modes 2-1 

Absolute 2-1,3 

Constant 2-1,6 

Relative 2-1,4 
ALF 3-7; A-4 
Arithmetic instructions 2-7 
ArithHietic operators 1-5 
ASCII codes Appendix C 
Assembler control 3-13; A-5 

EIF 3-16 

EQU 3-13 

IFA 3-15 

MON 3-17 

OPT 3-17 



\_/ A\ ij / \^i 



Assembler output b-i 
Assembler passes 

1 iii 

2 iii 

3 iii 
Assembly listing 5-2 

Cross reference 5-3 
Error 5-2 

Sample assembly 5-4 
Sample source program 



BSS 3-4; A-4 
BZS 3-4; A-4 



5-4 



Control options 5- 
C 5-1 
L, 5-1 
P 5-1 
X 5-1 



DAT 3-6; A-4 

Data storage 3-4; A-4 

BSS 3-4 

BZS 3-4 

COM 3-5 

DAT 3-6 
Data transmission 
DEC 3-10; A-4 



2-6 






i^^l^ Ij^twO 



tiandbook; 



EIF 3-16; A-5 
EJT 3-18; A-5 
EMC 4-2; A-5 
END 3-1; A-4 
ENT 3-2; A-4 
Error listing 5-2 
EQU 3-13; A-5 
Evaluation hierarchy 1-6 
EXT/EXT* 3-2; A-4 



I 
I 



C option 5-1 
COM 3-5; A-4 
Comment field 1-8 
Constant addressing 2-1,6 
Constant declarations 3-7; A-4 

ADC/ADC* 3-7 

ALF 3-7 

DEC 3-10 

NUM 3-9 

VFD 3-11 



IFA 3-15; A-5 

IFC 4-2; A-5 

Instruction format 1-1 
Source program 1-1 
Source statement 1-1 
Address field 1-2 
Comment field 1-8 
Instruction 1-2 
Location field 1-1 
Sequence field 1-8 

Inter-register 2-12 

Inter-register transfer A-3 
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I Jump instructions 2-9 



L option 5-1 

Listing control 3-18; A- 5 

EJT 3-18 

LST 3-18 

NLS 3-18 

SPC 3-18 
LOG 4-2; A-5 
Location field 1-1 
Logical instructions 2-8 
LST 3-18; A-5 



ivIAC 4-1; A-5 

Machine instructions 2-1; A-1 

Inter- register transfer 2-12; A-3 

Register reference 2-10; A-2 

Shift 2-14; A-2 

Skip 2-15; A-2 

Storage reference 2-1; A-1 
Macro assembler errors Appendix D 
Macro definition instructions A-5 
Macro instructions 4-4 

Actual parameters 4-4 

Null parameters 4-5 

Examples 4-6 
Macro library 4-10 
Macro pseudo instructions 4-1; A-4 
Macro skeleton 4-3 
Macros 

EMC 4-2 

IFC 4-2 

LOG 4-2 

MAC 4-1 
Mnemonic instruction codes Appendix A 
MON 3-17; A-5 



NAM 3-1; A-4 

Negative overflow /zero set 2-16 

NLS 3-18; A-5 

NUM 3-9; A-4 

Numeric operand 1-4 



Operation code field 1-2 
OPT 3-17; A-5 
I ORG/ORG* 3-14; A-5 



P option 5-1 
Parameters 4-4 

Actual 4-4 

Null 4-5 
Programming considerations Appendix B 
Pseudo instructions 3-1; A-4 

ADC/ADC* 3-7 

ALF 3-7 

BSS 3-4 

BZS 3-4 

COM 3-5 

DAT 3-6 

DEC 3-10 

EIF 3-16 

EJT 3-18 

END 3-1 

ENT 3-2 

EQU 3-13 

EXT/ EXT* 3-2 

IFA 3-15 

LST 3-18 

MON 3-17 

NAM 3-1 

NLS 3-18 

NUM 3-9 

OPT 3-17 

ORG/ORG* 3-14 

SPC 3-18 

VFD 3-11 



Register reference instructions 2-10 
Relative addressing 2-1,4 



Sample listing 5-4 
Sample program 5-4 
Sequence field 1-8 
Shift instructions 2-14; A-2 
Skip instructions 2-15; A-2 
Source program 1-1 
Source statement 1-1 
SPC 3-18; A-5 
Special characters 1-7 

Index 1-8 

Register 1-7 

Storage 1-7 
Statement label 1-1 
Storage reference instructions 2-1; A-1 

Absolute addressing 2-3 

Address modes 2-1 

Arithmetic 2-7 

Constant addressing 2-6 

Data transmission 2-6 



Index- 2 
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I Jump 2-9 TABLST iii 

IjOgical 2-8 

Relative addressing 2-4 
Subprogram linkage 3-1; A-4 
END 3-1 
ENT 3-2 
^i.^AiiAA-'- J-£, vFu a- il; A-4 

I NAM 3-1 

Symbolic operand 1-3 



X option 5-1 
XREF iv 
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